home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1994 …ember: Reference Library / Dev.CD Dec 94.toast / Technical Documentation / Mac Tech Notes (DocViewer) / NW • Networking / NW17 DAM Extensions < prev    next >
MacBinary  |  1994-10-19  |  93.8 KB  |  [ONLN/HLX2]

open in: MacOS 8.1     |     Win98     |     DOS

browse contents    |     view JSON data     |     view as text


This file was processed as: MacBinary (archive/macBinary).

ConfidenceProgramDetectionMatch TypeSupport
10% dexvert MacBinary (archive/macBinary) fallback Supported
100% file MacBinary II, inited, Fri Oct 7 10:00:41 1994, modified Wed Oct 19 08:09:36 1994, creator 'HLX2', type 'ONLN', 93351 bytes "NW17 DAM Extensions" , at 0x16d27 2366 bytes resource default (weak)
99% file data default
100% TrID MacBinary 2 default (weak)
100% siegfried fmt/1762 MacBinary (II) default
100% lsar MacBinary default


id metadata
keyvalue
macFileType[ONLN]
macFileCreator[HLX2]



hex view
+--------+-------------------------+-------------------------+--------+--------+
|00000000| 00 13 4e 57 31 37 20 44 | 41 4d 20 45 78 74 65 6e |..NW17 D|AM Exten|
|00000010| 73 69 6f 6e 73 00 00 00 | 00 00 00 00 00 00 00 00 |sions...|........|
|00000020| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000030| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000040| 00 4f 4e 4c 4e 48 4c 58 | 32 01 00 00 00 00 00 00 |.ONLNHLX|2.......|
|00000050| 00 00 00 00 01 6c a7 00 | 00 09 3e aa bb 05 09 aa |.....l..|..>.....|
|00000060| ca bd 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000070| 00 00 00 00 00 00 00 00 | 00 00 81 81 b2 42 00 00 |........|.....B..|
|00000080| 4e 57 20 31 37 20 2d 20 | 44 61 74 61 20 41 63 63 |NW 17 - |Data Acc|
|00000090| 65 73 73 20 45 78 74 65 | 6e 73 69 6f 6e 73 0d 4e |ess Exte|nsions.N|
|000000a0| 65 74 77 6f 72 6b 69 6e | 67 09 0d 57 72 69 74 74 |etworkin|g..Writt|
|000000b0| 65 6e 20 62 79 3a 09 43 | 68 75 71 20 56 6f 6e 20 |en by:.C|huq Von |
|000000c0| 52 6f 73 70 61 63 68 20 | 61 6e 64 20 44 61 6e 20 |Rospach |and Dan |
|000000d0| 53 74 72 6e 61 64 09 4d | 61 79 20 31 39 39 32 0d |Strnad.M|ay 1992.|
|000000e0| 54 68 69 73 20 54 65 63 | 68 6e 69 63 61 6c 20 4e |This Tec|hnical N|
|000000f0| 6f 74 65 20 64 69 73 63 | 75 73 73 65 73 20 63 6f |ote disc|usses co|
|00000100| 64 69 6e 67 20 64 61 74 | 61 20 61 63 63 65 73 73 |ding dat|a access|
|00000110| 20 65 78 74 65 6e 73 69 | 6f 6e 73 20 74 68 61 74 | extensi|ons that|
|00000120| 20 70 72 6f 76 69 64 65 | 20 61 6e 20 69 6e 74 65 | provide| an inte|
|00000130| 72 66 61 63 65 20 62 65 | 74 77 65 65 6e 20 74 68 |rface be|tween th|
|00000140| 65 20 44 61 74 61 20 41 | 63 63 65 73 73 20 4d 61 |e Data A|ccess Ma|
|00000150| 6e 61 67 65 72 20 61 6e | 64 20 72 65 6d 6f 74 65 |nager an|d remote|
|00000160| 20 64 61 74 61 20 73 6f | 75 72 63 65 73 2e 20 45 | data so|urces. E|
|00000170| 61 63 68 20 6f 66 20 74 | 68 65 20 66 75 6e 63 74 |ach of t|he funct|
|00000180| 69 6f 6e 73 20 74 68 61 | 74 20 61 20 64 61 74 61 |ions tha|t a data|
|00000190| 20 61 63 63 65 73 73 20 | 65 78 74 65 6e 73 69 6f | access |extensio|
|000001a0| 6e 20 6d 75 73 74 20 69 | 6d 70 6c 65 6d 65 6e 74 |n must i|mplement|
|000001b0| 20 69 73 20 64 65 73 63 | 72 69 62 65 64 2e 0d 49 | is desc|ribed..I|
|000001c0| 6e 74 72 6f 64 75 63 74 | 69 6f 6e 0d 41 20 64 61 |ntroduct|ion.A da|
|000001d0| 74 61 20 61 63 63 65 73 | 73 20 65 78 74 65 6e 73 |ta acces|s extens|
|000001e0| 69 6f 6e 20 69 73 20 61 | 20 70 72 6f 67 72 61 6d |ion is a| program|
|000001f0| 20 74 68 61 74 20 70 72 | 6f 76 69 64 65 73 20 61 | that pr|ovides a|
|00000200| 6e 20 69 6e 74 65 72 66 | 61 63 65 20 62 65 74 77 |n interf|ace betw|
|00000210| 65 65 6e 20 74 68 65 20 | 44 61 74 61 20 41 63 63 |een the |Data Acc|
|00000220| 65 73 73 20 4d 61 6e 61 | 67 65 72 20 61 6e 64 20 |ess Mana|ger and |
|00000230| 74 68 65 20 72 65 6d 6f | 74 65 20 64 61 74 61 20 |the remo|te data |
|00000240| 73 6f 75 72 63 65 2e 20 | 54 68 65 20 64 61 74 61 |source. |The data|
|00000250| 20 61 63 63 65 73 73 20 | 65 78 74 65 6e 73 69 6f | access |extensio|
|00000260| 6e 20 69 6d 70 6c 65 6d | 65 6e 74 73 20 61 6c 6c |n implem|ents all|
|00000270| 20 6f 66 20 74 68 65 20 | 6c 6f 77 2d 6c 65 76 65 | of the |low-leve|
|00000280| 6c 20 66 75 6e 63 74 69 | 6f 6e 73 20 61 6e 64 20 |l functi|ons and |
|00000290| 68 61 6e 64 6c 65 73 20 | 6e 65 74 77 6f 72 6b 20 |handles |network |
|000002a0| 63 6f 6d 6d 75 6e 69 63 | 61 74 69 6f 6e 20 66 6f |communic|ation fo|
|000002b0| 72 20 74 68 65 20 44 61 | 74 61 20 41 63 63 65 73 |r the Da|ta Acces|
|000002c0| 73 20 4d 61 6e 61 67 65 | 72 2e 20 42 65 63 61 75 |s Manage|r. Becau|
|000002d0| 73 65 20 74 68 65 20 64 | 61 74 61 20 61 63 63 65 |se the d|ata acce|
|000002e0| 73 73 20 65 78 74 65 6e | 73 69 6f 6e 20 69 6d 70 |ss exten|sion imp|
|000002f0| 6c 65 6d 65 6e 74 73 20 | 74 68 65 20 6c 6f 77 2d |lements |the low-|
|00000300| 6c 65 76 65 6c 20 44 61 | 74 61 20 41 63 63 65 73 |level Da|ta Acces|
|00000310| 73 20 4d 61 6e 61 67 65 | 72 20 66 75 6e 63 74 69 |s Manage|r functi|
|00000320| 6f 6e 73 2c 20 69 74 20 | 6d 75 73 74 20 72 65 74 |ons, it |must ret|
|00000330| 75 72 6e 20 61 70 70 72 | 6f 70 72 69 61 74 65 20 |urn appr|opriate |
|00000340| 72 65 73 75 6c 74 20 63 | 6f 64 65 73 20 61 6e 64 |result c|odes and|
|00000350| 20 68 61 6e 64 6c 65 20 | 61 73 79 6e 63 68 72 6f | handle |asynchro|
|00000360| 6e 6f 75 73 20 65 78 65 | 63 75 74 69 6f 6e 20 6f |nous exe|cution o|
|00000370| 66 20 66 75 6e 63 74 69 | 6f 6e 73 20 61 73 20 61 |f functi|ons as a|
|00000380| 70 70 72 6f 70 72 69 61 | 74 65 2e 0d 4e 6f 74 65 |ppropria|te..Note|
|00000390| 3a 09 45 61 63 68 20 64 | 61 74 61 20 61 63 63 65 |:.Each d|ata acce|
|000003a0| 73 73 20 65 78 74 65 6e | 73 69 6f 6e 20 63 6f 6e |ss exten|sion con|
|000003b0| 74 61 69 6e 73 20 61 20 | 66 6c 61 67 20 74 68 61 |tains a |flag tha|
|000003c0| 74 20 69 6e 64 69 63 61 | 74 65 73 20 74 6f 20 74 |t indica|tes to t|
|000003d0| 68 65 20 44 61 74 61 20 | 41 63 63 65 73 73 20 4d |he Data |Access M|
|000003e0| 61 6e 61 67 65 72 20 77 | 68 65 74 68 65 72 20 74 |anager w|hether t|
|000003f0| 68 65 20 64 61 74 61 20 | 61 63 63 65 73 73 20 65 |he data |access e|
|00000400| 78 74 65 6e 73 69 6f 6e | 20 73 75 70 70 6f 72 74 |xtension| support|
|00000410| 73 20 61 73 79 6e 63 68 | 72 6f 6e 6f 75 73 20 65 |s asynch|ronous e|
|00000420| 78 65 63 75 74 69 6f 6e | 20 6f 66 20 72 6f 75 74 |xecution| of rout|
|00000430| 69 6e 65 73 2e 20 49 66 | 20 61 6e 20 61 70 70 6c |ines. If| an appl|
|00000440| 69 63 61 74 69 6f 6e 20 | 61 74 74 65 6d 70 74 73 |ication |attempts|
|00000450| 20 74 6f 20 6d 61 6b 65 | 20 61 6e 20 61 73 79 6e | to make| an asyn|
|00000460| 63 68 72 6f 6e 6f 75 73 | 20 63 61 6c 6c 20 74 6f |chronous| call to|
|00000470| 20 61 20 64 61 74 61 20 | 61 63 63 65 73 73 20 65 | a data |access e|
|00000480| 78 74 65 6e 73 69 6f 6e | 20 74 68 61 74 20 68 61 |xtension| that ha|
|00000490| 73 20 74 68 65 20 66 69 | 72 73 74 20 62 69 74 20 |s the fi|rst bit |
|000004a0| 28 62 69 74 20 30 29 20 | 6f 66 20 74 68 65 20 66 |(bit 0) |of the f|
|000004b0| 6c 61 67 73 20 66 69 65 | 6c 64 20 63 6c 65 61 72 |lags fie|ld clear|
|000004c0| 65 64 20 74 6f 20 30 2c | 20 74 68 65 20 44 61 74 |ed to 0,| the Dat|
|000004d0| 61 20 41 63 63 65 73 73 | 20 4d 61 6e 61 67 65 72 |a Access| Manager|
|000004e0| 20 72 65 74 75 72 6e 73 | 20 61 20 72 65 73 75 6c | returns| a resul|
|000004f0| 74 20 63 6f 64 65 20 6f | 66 20 72 63 44 42 41 73 |t code o|f rcDBAs|
|00000500| 79 6e 63 4e 6f 74 53 75 | 70 70 20 61 6e 64 20 74 |yncNotSu|pp and t|
|00000510| 65 72 6d 69 6e 61 74 65 | 73 20 65 78 65 63 75 74 |erminate|s execut|
|00000520| 69 6f 6e 20 6f 66 20 74 | 68 65 20 72 6f 75 74 69 |ion of t|he routi|
|00000530| 6e 65 2e 20 54 6f 20 65 | 6e 73 75 72 65 20 63 6f |ne. To e|nsure co|
|00000540| 6d 70 61 74 69 62 69 6c | 69 74 79 20 09 6f 66 20 |mpatibil|ity .of |
|00000550| 79 6f 75 72 20 64 61 74 | 61 20 61 63 63 65 73 73 |your dat|a access|
|00000560| 20 65 78 74 65 6e 73 69 | 6f 6e 20 77 69 74 68 20 | extensi|on with |
|00000570| 61 6c 6c 20 61 70 70 6c | 69 63 61 74 69 6f 6e 73 |all appl|ications|
|00000580| 2c 20 79 6f 75 72 20 64 | 61 74 61 20 61 63 63 65 |, your d|ata acce|
|00000590| 73 73 20 65 78 74 65 6e | 73 69 6f 6e 20 73 68 6f |ss exten|sion sho|
|000005a0| 75 6c 64 20 73 75 70 70 | 6f 72 74 20 20 61 73 79 |uld supp|ort asy|
|000005b0| 6e 63 68 72 6f 6e 6f 75 | 73 20 65 78 65 63 75 74 |nchronou|s execut|
|000005c0| 69 6f 6e 20 6f 66 20 66 | 75 6e 63 74 69 6f 6e 73 |ion of f|unctions|
|000005d0| 2e 20 54 68 65 20 64 61 | 74 61 20 61 63 63 65 73 |. The da|ta acces|
|000005e0| 73 20 65 78 74 65 6e 73 | 69 6f 6e 20 66 6c 61 67 |s extens|ion flag|
|000005f0| 73 20 66 69 65 6c 64 20 | 69 73 20 64 65 73 63 72 |s field |is descr|
|00000600| 69 62 65 64 20 69 6e 20 | 74 68 65 20 6e 65 78 74 |ibed in |the next|
|00000610| 20 73 65 63 74 69 6f 6e | 2c 20 d2 43 6f 6e 74 65 | section|, .Conte|
|00000620| 6e 74 73 20 6f 66 20 61 | 20 44 61 74 61 20 41 63 |nts of a| Data Ac|
|00000630| 63 65 73 73 20 45 78 74 | 65 6e 73 69 6f 6e 2e d3 |cess Ext|ension..|
|00000640| 0d 41 73 20 73 6f 6f 6e | 20 61 73 20 74 68 65 20 |.As soon| as the |
|00000650| 64 61 74 61 20 61 63 63 | 65 73 73 20 65 78 74 65 |data acc|ess exte|
|00000660| 6e 73 69 6f 6e 20 62 65 | 67 69 6e 73 20 65 78 65 |nsion be|gins exe|
|00000670| 63 75 74 69 6f 6e 20 6f | 66 20 61 6e 20 61 73 79 |cution o|f an asy|
|00000680| 6e 63 68 72 6f 6e 6f 75 | 73 20 72 6f 75 74 69 6e |nchronou|s routin|
|00000690| 65 2c 20 69 74 20 73 68 | 6f 75 6c 64 20 72 65 74 |e, it sh|ould ret|
|000006a0| 75 72 6e 20 61 20 6e 6f | 45 72 72 20 72 65 73 75 |urn a no|Err resu|
|000006b0| 6c 74 20 63 6f 64 65 20 | 66 6f 72 20 74 68 65 20 |lt code |for the |
|000006c0| 66 75 6e 63 74 69 6f 6e | 20 72 65 73 75 6c 74 20 |function| result |
|000006d0| 61 6e 64 20 73 65 74 20 | 74 68 65 20 72 65 73 75 |and set |the resu|
|000006e0| 6c 74 20 66 69 65 6c 64 | 20 6f 66 20 74 68 65 20 |lt field| of the |
|000006f0| 61 73 79 6e 63 68 72 6f | 6e 6f 75 73 20 70 61 72 |asynchro|nous par|
|00000700| 61 6d 65 74 65 72 20 62 | 6c 6f 63 6b 20 74 6f 20 |ameter b|lock to |
|00000710| 31 2e 20 49 74 20 73 68 | 6f 75 6c 64 20 72 65 74 |1. It sh|ould ret|
|00000720| 75 72 6e 20 63 6f 6e 74 | 72 6f 6c 20 74 6f 20 74 |urn cont|rol to t|
|00000730| 68 65 20 63 61 6c 6c 69 | 6e 67 20 72 6f 75 74 69 |he calli|ng routi|
|00000740| 6e 65 20 61 73 20 71 75 | 69 63 6b 6c 79 20 61 73 |ne as qu|ickly as|
|00000750| 20 70 6f 73 73 69 62 6c | 65 2e 20 57 68 65 6e 20 | possibl|e. When |
|00000760| 69 74 20 74 65 72 6d 69 | 6e 61 74 65 73 20 65 78 |it termi|nates ex|
|00000770| 65 63 75 74 69 6f 6e 20 | 6f 66 20 74 68 65 20 72 |ecution |of the r|
|00000780| 6f 75 74 69 6e 65 2c 20 | 74 68 65 20 64 61 74 61 |outine, |the data|
|00000790| 20 61 63 63 65 73 73 20 | 65 78 74 65 6e 73 69 6f | access |extensio|
|000007a0| 6e 20 6d 75 73 74 20 70 | 6c 61 63 65 20 74 68 65 |n must p|lace the|
|000007b0| 20 72 65 74 75 72 6e 20 | 63 6f 64 65 20 69 6e 20 | return |code in |
|000007c0| 74 68 65 20 72 65 73 75 | 6c 74 20 66 69 65 6c 64 |the resu|lt field|
|000007d0| 2e 20 52 65 73 75 6c 74 | 20 63 6f 64 65 73 20 66 |. Result| codes f|
|000007e0| 6f 72 20 65 61 63 68 20 | 6f 66 20 74 68 65 20 64 |or each |of the d|
|000007f0| 61 74 61 20 61 63 63 65 | 73 73 20 65 78 74 65 6e |ata acce|ss exten|
|00000800| 73 69 6f 6e 20 72 6f 75 | 74 69 6e 65 73 20 61 72 |sion rou|tines ar|
|00000810| 65 20 6c 69 73 74 65 64 | 20 69 6e 20 74 68 65 20 |e listed| in the |
|00000820| 6e 65 78 74 20 73 65 63 | 74 69 6f 6e 2e 20 54 68 |next sec|tion. Th|
|00000830| 65 20 61 73 79 6e 63 68 | 72 6f 6e 6f 75 73 20 70 |e asynch|ronous p|
|00000840| 61 72 61 6d 65 74 65 72 | 20 62 6c 6f 63 6b 20 69 |arameter| block i|
|00000850| 73 20 64 65 73 63 72 69 | 62 65 64 20 69 6e 20 d2 |s descri|bed in .|
|00000860| 41 73 79 6e 63 68 72 6f | 6e 6f 75 73 20 45 78 65 |Asynchro|nous Exe|
|00000870| 63 75 74 69 6f 6e 20 6f | 66 20 52 6f 75 74 69 6e |cution o|f Routin|
|00000880| 65 73 d3 20 69 6e 20 74 | 68 65 20 44 61 74 61 20 |es. in t|he Data |
|00000890| 41 63 63 65 73 73 20 4d | 61 6e 61 67 65 72 20 63 |Access M|anager c|
|000008a0| 68 61 70 74 65 72 20 6f | 66 20 49 6e 73 69 64 65 |hapter o|f Inside|
|000008b0| 20 4d 61 63 69 6e 74 6f | 73 68 20 56 6f 6c 75 6d | Macinto|sh Volum|
|000008c0| 65 20 56 49 2c 20 70 61 | 67 65 20 38 2d 35 30 2e |e VI, pa|ge 8-50.|
|000008d0| 20 0d 57 68 65 6e 20 74 | 68 65 20 64 61 74 61 20 | .When t|he data |
|000008e0| 61 63 63 65 73 73 20 65 | 78 74 65 6e 73 69 6f 6e |access e|xtension|
|000008f0| 20 68 61 73 20 63 6f 6d | 70 6c 65 74 65 64 20 65 | has com|pleted e|
|00000900| 78 65 63 75 74 69 6f 6e | 20 6f 66 20 61 6e 20 61 |xecution| of an a|
|00000910| 73 79 6e 63 68 72 6f 6e | 6f 75 73 20 72 6f 75 74 |synchron|ous rout|
|00000920| 69 6e 65 2c 20 69 74 20 | 6d 75 73 74 20 63 61 6c |ine, it |must cal|
|00000930| 6c 20 74 68 65 20 61 70 | 70 6c 69 63 61 74 69 6f |l the ap|plicatio|
|00000940| 6e d5 73 20 63 6f 6d 70 | 6c 65 74 69 6f 6e 20 72 |n.s comp|letion r|
|00000950| 6f 75 74 69 6e 65 20 70 | 6f 69 6e 74 65 64 20 74 |outine p|ointed t|
|00000960| 6f 20 62 79 20 74 68 65 | 20 63 6f 6d 70 6c 65 74 |o by the| complet|
|00000970| 69 6f 6e 50 72 6f 63 20 | 66 69 65 6c 64 20 6f 66 |ionProc |field of|
|00000980| 20 74 68 65 20 61 73 79 | 6e 63 68 72 6f 6e 6f 75 | the asy|nchronou|
|00000990| 73 20 70 61 72 61 6d 65 | 74 65 72 20 62 6c 6f 63 |s parame|ter bloc|
|000009a0| 6b 2e 20 54 68 65 20 63 | 6f 6d 70 6c 65 74 69 6f |k. The c|ompletio|
|000009b0| 6e 20 72 6f 75 74 69 6e | 65 20 69 73 20 64 65 73 |n routin|e is des|
|000009c0| 63 72 69 62 65 64 20 69 | 6e 20 d2 41 73 79 6e 63 |cribed i|n .Async|
|000009d0| 68 72 6f 6e 6f 75 73 20 | 45 78 65 63 75 74 69 6f |hronous |Executio|
|000009e0| 6e 20 6f 66 20 52 6f 75 | 74 69 6e 65 73 d3 20 69 |n of Rou|tines. i|
|000009f0| 6e 20 74 68 65 20 44 61 | 74 61 20 41 63 63 65 73 |n the Da|ta Acces|
|00000a00| 73 20 4d 61 6e 61 67 65 | 72 20 63 68 61 70 74 65 |s Manage|r chapte|
|00000a10| 72 20 6f 66 20 49 6e 73 | 69 64 65 20 4d 61 63 69 |r of Ins|ide Maci|
|00000a20| 6e 74 6f 73 68 20 56 6f | 6c 75 6d 65 20 56 49 2c |ntosh Vo|lume VI,|
|00000a30| 20 70 61 67 65 20 38 2d | 35 30 2e 0d 54 68 65 20 | page 8-|50..The |
|00000a40| 64 61 74 61 20 61 63 63 | 65 73 73 20 65 78 74 65 |data acc|ess exte|
|00000a50| 6e 73 69 6f 6e 20 63 61 | 6e 20 75 73 65 20 74 68 |nsion ca|n use th|
|00000a60| 65 20 64 64 65 76 52 65 | 66 20 66 69 65 6c 64 20 |e ddevRe|f field |
|00000a70| 69 6e 20 74 68 65 20 61 | 73 79 6e 63 68 72 6f 6e |in the a|synchron|
|00000a80| 6f 75 73 20 70 61 72 61 | 6d 65 74 65 72 20 62 6c |ous para|meter bl|
|00000a90| 6f 63 6b 20 66 6f 72 20 | 69 74 73 20 6f 77 6e 20 |ock for |its own |
|00000aa0| 70 75 72 70 6f 73 65 73 | 2e 20 0d 54 68 69 73 20 |purposes|. .This |
|00000ab0| 54 65 63 68 20 4e 6f 74 | 65 20 64 65 73 63 72 69 |Tech Not|e descri|
|00000ac0| 62 65 73 20 65 61 63 68 | 20 6f 66 20 74 68 65 20 |bes each| of the |
|00000ad0| 66 75 6e 63 74 69 6f 6e | 73 20 74 68 61 74 20 61 |function|s that a|
|00000ae0| 20 64 61 74 61 20 61 63 | 63 65 73 73 20 65 78 74 | data ac|cess ext|
|00000af0| 65 6e 73 69 6f 6e 20 6d | 75 73 74 20 69 6d 70 6c |ension m|ust impl|
|00000b00| 65 6d 65 6e 74 2e 20 0d | 43 6f 6e 74 65 6e 74 73 |ement. .|Contents|
|00000b10| 20 6f 66 20 61 20 44 61 | 74 61 20 41 63 63 65 73 | of a Da|ta Acces|
|00000b20| 73 20 45 78 74 65 6e 73 | 69 6f 6e 0d 41 20 64 61 |s Extens|ion.A da|
|00000b30| 74 61 20 61 63 63 65 73 | 73 20 65 78 74 65 6e 73 |ta acces|s extens|
|00000b40| 69 6f 6e 20 63 6f 6e 73 | 69 73 74 73 20 6f 66 20 |ion cons|ists of |
|00000b50| 61 20 66 69 6c 65 20 6f | 66 20 74 79 70 65 20 27 |a file o|f type '|
|00000b60| 64 64 65 76 27 2c 20 6c | 6f 63 61 74 65 64 20 69 |ddev', l|ocated i|
|00000b70| 6e 20 74 68 65 20 45 78 | 74 65 6e 73 69 6f 6e 73 |n the Ex|tensions|
|00000b80| 20 46 6f 6c 64 65 72 2e | 20 54 68 65 20 64 61 74 | Folder.| The dat|
|00000b90| 61 20 61 63 63 65 73 73 | 20 65 78 74 65 6e 73 69 |a access| extensi|
|00000ba0| 6f 6e 20 66 69 6c 65 20 | 6d 75 73 74 20 63 6f 6e |on file |must con|
|00000bb0| 74 61 69 6e 20 74 68 65 | 73 65 20 72 65 73 6f 75 |tain the|se resou|
|00000bc0| 72 63 65 73 3a 0d 20 20 | 20 20 20 27 64 64 65 76 |rces:. | 'ddev|
|00000bd0| 27 20 28 66 75 6e 63 74 | 69 6f 6e 3b 20 72 65 73 |' (funct|ion; res|
|00000be0| 6f 75 72 63 65 20 49 44 | 20 69 73 20 31 32 38 29 |ource ID| is 128)|
|00000bf0| 0d 20 20 20 20 20 27 53 | 54 52 ca 27 20 28 6e 61 |. 'S|TR.' (na|
|00000c00| 6d 65 20 6f 66 20 64 61 | 74 61 20 61 63 63 65 73 |me of da|ta acces|
|00000c10| 73 20 65 78 74 65 6e 73 | 69 6f 6e 3b 20 72 65 73 |s extens|ion; res|
|00000c20| 6f 75 72 63 65 20 49 44 | 20 69 73 20 31 32 38 29 |ource ID| is 128)|
|00000c30| 0d 20 20 20 20 20 27 64 | 66 6c 67 27 20 28 76 65 |. 'd|flg' (ve|
|00000c40| 72 73 69 6f 6e 20 6e 75 | 6d 62 65 72 20 61 6e 64 |rsion nu|mber and|
|00000c50| 20 66 6c 61 67 73 3b 20 | 72 65 73 6f 75 72 63 65 | flags; |resource|
|00000c60| 20 49 44 20 69 73 20 31 | 32 38 29 0d 54 68 65 20 | ID is 1|28).The |
|00000c70| 27 64 64 65 76 27 20 72 | 65 73 6f 75 72 63 65 20 |'ddev' r|esource |
|00000c80| 63 6f 6e 74 61 69 6e 73 | 20 61 20 66 75 6e 63 74 |contains| a funct|
|00000c90| 69 6f 6e 20 74 68 61 74 | 20 69 6d 70 6c 65 6d 65 |ion that| impleme|
|00000ca0| 6e 74 73 20 61 6c 6c 20 | 6f 66 20 74 68 65 20 6c |nts all |of the l|
|00000cb0| 6f 77 2d 6c 65 76 65 6c | 20 44 61 74 61 20 41 63 |ow-level| Data Ac|
|00000cc0| 63 65 73 73 20 4d 61 6e | 61 67 65 72 20 66 75 6e |cess Man|ager fun|
|00000cd0| 63 74 69 6f 6e 73 2e 20 | 54 68 65 20 44 61 74 61 |ctions. |The Data|
|00000ce0| 20 41 63 63 65 73 73 20 | 4d 61 6e 61 67 65 72 20 | Access |Manager |
|00000cf0| 63 61 6c 6c 73 20 74 68 | 65 20 64 64 65 76 20 66 |calls th|e ddev f|
|00000d00| 75 6e 63 74 69 6f 6e 20 | 77 68 65 6e 65 76 65 72 |unction |whenever|
|00000d10| 20 74 68 65 20 6d 61 6e | 61 67 65 72 20 6e 65 65 | the man|ager nee|
|00000d20| 64 73 20 74 6f 20 65 78 | 65 63 75 74 65 20 61 20 |ds to ex|ecute a |
|00000d30| 6c 6f 77 2d 6c 65 76 65 | 6c 20 66 75 6e 63 74 69 |low-leve|l functi|
|00000d40| 6f 6e 2e 20 0d 48 65 72 | 65 20 69 73 20 61 20 66 |on. .Her|e is a f|
|00000d50| 75 6e 63 74 69 6f 6e 20 | 64 65 63 6c 61 72 61 74 |unction |declarat|
|00000d60| 69 6f 6e 20 66 6f 72 20 | 61 20 64 64 65 76 20 66 |ion for |a ddev f|
|00000d70| 75 6e 63 74 69 6f 6e 2e | 0d 20 20 20 20 20 46 55 |unction.|. FU|
|00000d80| 4e 43 54 49 4f 4e 20 4d | 79 44 44 65 76 28 70 61 |NCTION M|yDDev(pa|
|00000d90| 72 61 6d 73 3a 20 44 44 | 45 56 50 61 72 61 6d 73 |rams: DD|EVParams|
|00000da0| 29 20 3a 20 4f 53 45 72 | 72 3b 0d 54 68 65 20 70 |) : OSEr|r;.The p|
|00000db0| 61 72 61 6d 73 20 70 61 | 72 61 6d 65 74 65 72 20 |arams pa|rameter |
|00000dc0| 69 73 20 61 20 70 61 72 | 61 6d 65 74 65 72 20 62 |is a par|ameter b|
|00000dd0| 6c 6f 63 6b 20 74 68 61 | 74 20 69 6e 63 6c 75 64 |lock tha|t includ|
|00000de0| 65 73 20 61 20 72 6f 75 | 74 69 6e 65 20 73 65 6c |es a rou|tine sel|
|00000df0| 65 63 74 6f 72 2e 20 54 | 68 65 20 64 61 74 61 20 |ector. T|he data |
|00000e00| 61 63 63 65 73 73 20 65 | 78 74 65 6e 73 69 6f 6e |access e|xtension|
|00000e10| 20 70 61 72 61 6d 65 74 | 65 72 20 62 6c 6f 63 6b | paramet|er block|
|00000e20| 20 69 73 20 64 65 73 63 | 72 69 62 65 64 20 69 6e | is desc|ribed in|
|00000e30| 20 74 68 65 20 6e 65 78 | 74 20 73 65 63 74 69 6f | the nex|t sectio|
|00000e40| 6e 2c 20 d2 44 61 74 61 | 20 41 63 63 65 73 73 20 |n, .Data| Access |
|00000e50| 45 78 74 65 6e 73 69 6f | 6e 20 50 61 72 61 6d 65 |Extensio|n Parame|
|00000e60| 74 65 72 73 2e d3 20 0d | 59 6f 75 20 6d 75 73 74 |ters.. .|You must|
|00000e70| 20 73 65 74 20 62 69 74 | 20 36 20 6f 66 20 74 68 | set bit| 6 of th|
|00000e80| 65 20 72 65 73 6f 75 72 | 63 65 20 61 74 74 72 69 |e resour|ce attri|
|00000e90| 62 75 74 65 20 62 79 74 | 65 20 74 6f 20 31 20 66 |bute byt|e to 1 f|
|00000ea0| 6f 72 20 74 68 65 20 27 | 64 64 65 76 27 20 72 65 |or the '|ddev' re|
|00000eb0| 73 6f 75 72 63 65 20 73 | 6f 20 74 68 61 74 20 74 |source s|o that t|
|00000ec0| 68 65 20 72 65 73 6f 75 | 72 63 65 20 69 73 20 72 |he resou|rce is r|
|00000ed0| 65 61 64 20 69 6e 74 6f | 20 74 68 65 20 73 79 73 |ead into| the sys|
|00000ee0| 74 65 6d 20 68 65 61 70 | 2e 20 52 65 73 6f 75 72 |tem heap|. Resour|
|00000ef0| 63 65 20 61 74 74 72 69 | 62 75 74 65 73 20 61 72 |ce attri|butes ar|
|00000f00| 65 20 64 69 73 63 75 73 | 73 65 64 20 69 6e 20 74 |e discus|sed in t|
|00000f10| 68 65 20 52 65 73 6f 75 | 72 63 65 20 4d 61 6e 61 |he Resou|rce Mana|
|00000f20| 67 65 72 20 63 68 61 70 | 74 65 72 20 6f 66 20 6f |ger chap|ter of o|
|00000f30| 66 20 49 6e 73 69 64 65 | 20 4d 61 63 69 6e 74 6f |f Inside| Macinto|
|00000f40| 73 68 20 20 56 6f 6c 75 | 6d 65 20 49 2e 0d 54 68 |sh Volu|me I..Th|
|00000f50| 65 20 27 53 54 52 ca 27 | 20 72 65 73 6f 75 72 63 |e 'STR.'| resourc|
|00000f60| 65 20 6d 75 73 74 20 63 | 6f 6e 74 61 69 6e 20 61 |e must c|ontain a|
|00000f70| 20 63 68 61 72 61 63 74 | 65 72 20 73 74 72 69 6e | charact|er strin|
|00000f80| 67 20 6f 66 20 6e 6f 74 | 20 6d 6f 72 65 20 74 68 |g of not| more th|
|00000f90| 61 6e 20 36 33 20 63 68 | 61 72 61 63 74 65 72 73 |an 63 ch|aracters|
|00000fa0| 20 74 68 61 74 20 73 70 | 65 63 69 66 69 65 73 20 | that sp|ecifies |
|00000fb0| 74 68 65 20 6e 61 6d 65 | 20 6f 66 20 74 68 65 20 |the name| of the |
|00000fc0| 64 61 74 61 20 61 63 63 | 65 73 73 20 65 78 74 65 |data acc|ess exte|
|00000fd0| 6e 73 69 6f 6e 2e 20 55 | 6e 64 65 72 20 74 73 79 |nsion. U|nder tsy|
|00000fe0| 73 74 65 6d 20 37 2e 30 | 20 6f 72 20 6c 61 74 65 |stem 7.0| or late|
|00000ff0| 72 2c 20 74 68 65 20 64 | 61 74 61 20 61 63 63 65 |r, the d|ata acce|
|00001000| 73 73 20 65 78 74 65 6e | 73 69 6f 6e 20 69 73 20 |ss exten|sion is |
|00001010| 61 73 73 75 6d 65 64 20 | 20 74 6f 20 72 65 73 69 |assumed | to resi|
|00001020| 64 65 20 69 6e 20 74 68 | 65 20 22 45 78 74 65 6e |de in th|e "Exten|
|00001030| 73 69 6f 6e 73 22 20 66 | 6f 6c 64 65 72 20 77 69 |sions" f|older wi|
|00001040| 74 68 69 6e 20 74 68 65 | 20 53 79 73 74 65 6d 20 |thin the| System |
|00001050| 66 6f 6c 64 65 72 2e 20 | 54 68 65 20 64 61 74 61 |folder. |The data|
|00001060| 20 61 63 63 65 73 73 20 | 65 78 74 65 6e 73 69 6f | access |extensio|
|00001070| 6e 20 6e 61 6d 65 20 69 | 73 20 61 20 70 61 72 61 |n name i|s a para|
|00001080| 6d 65 74 65 72 20 74 6f | 20 74 68 65 20 44 42 49 |meter to| the DBI|
|00001090| 6e 69 74 20 66 75 6e 63 | 74 69 6f 6e 2e 0d 54 68 |nit func|tion..Th|
|000010a0| 65 20 27 64 66 6c 67 27 | 20 72 65 73 6f 75 72 63 |e 'dflg'| resourc|
|000010b0| 65 20 63 6f 6e 74 61 69 | 6e 73 20 74 77 6f 20 34 |e contai|ns two 4|
|000010c0| 2d 62 79 74 65 20 66 69 | 65 6c 64 73 2c 20 61 73 |-byte fi|elds, as|
|000010d0| 20 66 6f 6c 6c 6f 77 73 | 3a 0d 54 59 50 45 20 44 | follows|:.TYPE D|
|000010e0| 44 45 56 46 6c 61 67 73 | 20 3d 20 0d 52 45 43 4f |DEVFlags| = .RECO|
|000010f0| 52 44 0d 09 76 65 72 73 | 69 6f 6e 3a 09 4c 6f 6e |RD..vers|ion:.Lon|
|00001100| 67 49 6e 74 3b 09 7b 64 | 61 74 61 20 61 63 63 65 |gInt;.{d|ata acce|
|00001110| 73 73 20 65 78 74 65 6e | 73 69 6f 6e 20 66 6f 72 |ss exten|sion for|
|00001120| 6d 61 74 7d 0d 09 66 6c | 61 67 73 3a 09 09 4c 6f |mat}..fl|ags:..Lo|
|00001130| 6e 67 49 6e 74 09 7b 64 | 61 74 61 20 61 63 63 65 |ngInt.{d|ata acce|
|00001140| 73 73 20 65 78 74 65 6e | 73 69 6f 6e 20 66 6c 61 |ss exten|sion fla|
|00001150| 67 73 7d 0d 45 4e 44 3b | 0d 54 68 65 20 76 65 72 |gs}.END;|.The ver|
|00001160| 73 69 6f 6e 20 66 69 65 | 6c 64 20 69 6e 64 69 63 |sion fie|ld indic|
|00001170| 61 74 65 73 20 74 68 65 | 20 76 65 72 73 69 6f 6e |ates the| version|
|00001180| 20 6f 66 20 74 68 65 20 | 64 61 74 61 20 61 63 63 | of the |data acc|
|00001190| 65 73 73 20 65 78 74 65 | 6e 73 69 6f 6e 20 66 6f |ess exte|nsion fo|
|000011a0| 72 6d 61 74 20 75 73 65 | 64 20 66 6f 72 20 74 68 |rmat use|d for th|
|000011b0| 69 73 20 64 61 74 61 20 | 61 63 63 65 73 73 20 65 |is data |access e|
|000011c0| 78 74 65 6e 73 69 6f 6e | 2e 20 49 74 20 6d 75 73 |xtension|. It mus|
|000011d0| 74 20 62 65 20 73 65 74 | 20 74 6f 20 30 20 66 6f |t be set| to 0 fo|
|000011e0| 72 20 74 68 65 20 76 65 | 72 73 69 6f 6e 20 37 2e |r the ve|rsion 7.|
|000011f0| 30 20 44 61 74 61 20 41 | 63 63 65 73 73 20 4d 61 |0 Data A|ccess Ma|
|00001200| 6e 61 67 65 72 2e 0d 54 | 68 65 20 66 6c 61 67 73 |nager..T|he flags|
|00001210| 20 66 69 65 6c 64 20 73 | 70 65 63 69 66 69 65 73 | field s|pecifies|
|00001220| 20 66 6c 61 67 73 20 74 | 68 61 74 20 74 68 65 20 | flags t|hat the |
|00001230| 64 61 74 61 20 61 63 63 | 65 73 73 20 65 78 74 65 |data acc|ess exte|
|00001240| 6e 73 69 6f 6e 20 6d 75 | 73 74 20 73 65 74 2e 20 |nsion mu|st set. |
|00001250| 41 74 20 70 72 65 73 65 | 6e 74 2c 20 6f 6e 6c 79 |At prese|nt, only|
|00001260| 20 74 68 65 20 6c 65 61 | 73 74 20 73 69 67 6e 69 | the lea|st signi|
|00001270| 66 69 63 61 6e 74 20 62 | 69 74 20 69 73 20 64 65 |ficant b|it is de|
|00001280| 66 69 6e 65 64 3b 20 61 | 6c 6c 20 6f 74 68 65 72 |fined; a|ll other|
|00001290| 20 62 69 74 73 20 6d 75 | 73 74 20 62 65 20 63 6c | bits mu|st be cl|
|000012a0| 65 61 72 65 64 20 74 6f | 20 30 2e 20 53 65 74 20 |eared to| 0. Set |
|000012b0| 74 68 65 20 66 6c 61 67 | 73 20 66 69 65 6c 64 20 |the flag|s field |
|000012c0| 74 6f 20 74 68 65 20 63 | 6f 6e 73 74 61 6e 74 20 |to the c|onstant |
|000012d0| 6b 41 73 79 6e 63 53 75 | 70 70 6f 72 74 65 64 20 |kAsyncSu|pported |
|000012e0| 28 74 68 61 74 20 69 73 | 2c 20 73 65 74 20 74 68 |(that is|, set th|
|000012f0| 65 20 6c 65 61 73 74 20 | 73 69 67 6e 69 66 69 63 |e least |signific|
|00001300| 61 6e 74 20 62 69 74 20 | 74 6f 20 31 29 20 69 66 |ant bit |to 1) if|
|00001310| 20 74 68 69 73 20 64 61 | 74 61 20 61 63 63 65 73 | this da|ta acces|
|00001320| 73 20 65 78 74 65 6e 73 | 69 6f 6e 20 73 75 70 70 |s extens|ion supp|
|00001330| 6f 72 74 73 20 61 73 79 | 6e 63 68 72 6f 6e 6f 75 |orts asy|nchronou|
|00001340| 73 20 63 61 6c 6c 73 2c | 20 6f 72 20 74 6f 20 30 |s calls,| or to 0|
|00001350| 20 69 66 20 69 74 20 64 | 6f 65 73 20 6e 6f 74 2e | if it d|oes not.|
|00001360| 20 49 66 20 61 6e 20 61 | 70 70 6c 69 63 61 74 69 | If an a|pplicati|
|00001370| 6f 6e 20 61 74 74 65 6d | 70 74 73 20 74 6f 20 6d |on attem|pts to m|
|00001380| 61 6b 65 20 61 6e 20 61 | 73 79 6e 63 68 72 6f 6e |ake an a|synchron|
|00001390| 6f 75 73 20 63 61 6c 6c | 20 74 6f 20 61 20 64 61 |ous call| to a da|
|000013a0| 74 61 20 61 63 63 65 73 | 73 20 65 78 74 65 6e 73 |ta acces|s extens|
|000013b0| 69 6f 6e 20 74 68 61 74 | 20 68 61 73 20 74 68 65 |ion that| has the|
|000013c0| 20 66 6c 61 67 73 20 66 | 69 65 6c 64 20 63 6c 65 | flags f|ield cle|
|000013d0| 61 72 65 64 20 74 6f 20 | 30 2c 20 74 68 65 20 44 |ared to |0, the D|
|000013e0| 61 74 61 20 41 63 63 65 | 73 73 20 4d 61 6e 61 67 |ata Acce|ss Manag|
|000013f0| 65 72 20 72 65 74 75 72 | 6e 73 20 61 20 72 65 73 |er retur|ns a res|
|00001400| 75 6c 74 20 63 6f 64 65 | 20 6f 66 20 72 63 44 42 |ult code| of rcDB|
|00001410| 41 73 79 6e 63 4e 6f 74 | 53 75 70 70 2e 20 0d 44 |AsyncNot|Supp. .D|
|00001420| 61 74 61 20 41 63 63 65 | 73 73 20 45 78 74 65 6e |ata Acce|ss Exten|
|00001430| 73 69 6f 6e 20 50 61 72 | 61 6d 65 74 65 72 73 0d |sion Par|ameters.|
|00001440| 54 68 69 73 20 73 65 63 | 74 69 6f 6e 20 64 65 73 |This sec|tion des|
|00001450| 63 72 69 62 65 73 20 74 | 68 65 20 70 61 72 61 6d |cribes t|he param|
|00001460| 65 74 65 72 20 62 6c 6f | 63 6b 20 74 68 61 74 20 |eter blo|ck that |
|00001470| 74 68 65 20 44 61 74 61 | 20 41 63 63 65 73 73 20 |the Data| Access |
|00001480| 4d 61 6e 61 67 65 72 20 | 70 61 73 73 65 73 20 74 |Manager |passes t|
|00001490| 6f 20 61 20 64 61 74 61 | 20 61 63 63 65 73 73 20 |o a data| access |
|000014a0| 65 78 74 65 6e 73 69 6f | 6e 2e 20 54 68 65 20 73 |extensio|n. The s|
|000014b0| 65 63 74 69 6f 6e 20 d2 | 44 61 74 61 20 41 63 63 |ection .|Data Acc|
|000014c0| 65 73 73 20 45 78 74 65 | 6e 73 69 6f 6e 20 4d 65 |ess Exte|nsion Me|
|000014d0| 73 73 61 67 65 73 d3 20 | 73 70 65 63 69 66 69 65 |ssages. |specifie|
|000014e0| 73 20 77 68 69 63 68 20 | 70 61 72 61 6d 65 74 65 |s which |paramete|
|000014f0| 72 73 20 61 72 65 20 73 | 69 67 6e 69 66 69 63 61 |rs are s|ignifica|
|00001500| 6e 74 20 66 6f 72 20 65 | 61 63 68 20 74 79 70 65 |nt for e|ach type|
|00001510| 20 6f 66 20 72 6f 75 74 | 69 6e 65 20 61 6e 64 20 | of rout|ine and |
|00001520| 77 68 65 74 68 65 72 20 | 65 61 63 68 20 76 61 6c |whether |each val|
|00001530| 75 65 20 69 73 20 70 61 | 73 73 65 64 20 74 6f 20 |ue is pa|ssed to |
|00001540| 74 68 65 20 64 61 74 61 | 20 61 63 63 65 73 73 20 |the data| access |
|00001550| 65 78 74 65 6e 73 69 6f | 6e 20 6f 72 20 72 65 74 |extensio|n or ret|
|00001560| 75 72 6e 65 64 20 62 79 | 20 74 68 65 20 64 61 74 |urned by| the dat|
|00001570| 61 20 61 63 63 65 73 73 | 20 65 78 74 65 6e 73 69 |a access| extensi|
|00001580| 6f 6e 2e 0d 54 68 65 20 | 44 61 74 61 20 41 63 63 |on..The |Data Acc|
|00001590| 65 73 73 20 4d 61 6e 61 | 67 65 72 20 70 61 73 73 |ess Mana|ger pass|
|000015a0| 65 73 20 61 20 70 61 72 | 61 6d 65 74 65 72 20 62 |es a par|ameter b|
|000015b0| 6c 6f 63 6b 20 74 6f 20 | 61 20 64 61 74 61 20 61 |lock to |a data a|
|000015c0| 63 63 65 73 73 20 65 78 | 74 65 6e 73 69 6f 6e 2e |ccess ex|tension.|
|000015d0| 20 54 68 65 20 70 61 72 | 61 6d 65 74 65 72 20 62 | The par|ameter b|
|000015e0| 6c 6f 63 6b 20 69 73 20 | 64 65 66 69 6e 65 64 20 |lock is |defined |
|000015f0| 61 73 20 61 20 44 44 45 | 56 50 61 72 61 6d 73 20 |as a DDE|VParams |
|00001600| 72 65 63 6f 72 64 2e 0d | 54 59 50 45 20 44 44 45 |record..|TYPE DDE|
|00001610| 56 50 61 72 61 6d 73 20 | 3d 20 0d 52 45 43 4f 52 |VParams |= .RECOR|
|00001620| 44 0d 09 6d 65 73 73 61 | 67 65 3a 09 49 6e 74 65 |D..messa|ge:.Inte|
|00001630| 67 65 72 3b 09 7b 72 6f | 75 74 69 6e 65 20 73 65 |ger;.{ro|utine se|
|00001640| 6c 65 63 74 6f 72 7d 0d | 09 64 64 65 76 53 74 6f |lector}.|.ddevSto|
|00001650| 72 61 67 65 3a 09 4c 6f | 6e 67 49 6e 74 3b 09 7b |rage:.Lo|ngInt;.{|
|00001660| 73 74 6f 72 61 67 65 20 | 66 6f 72 20 75 73 65 20 |storage |for use |
|00001670| 62 79 20 7d 0d 09 09 09 | 7b 20 64 61 74 61 20 61 |by }....|{ data a|
|00001680| 63 63 65 73 73 20 65 78 | 74 65 6e 73 69 6f 6e 7d |ccess ex|tension}|
|00001690| 0d 09 61 73 79 6e 63 50 | 42 3a 09 44 42 41 73 79 |..asyncP|B:.DBAsy|
|000016a0| 6e 63 50 61 72 6d 42 6c | 6b 50 74 72 3b 09 0d 09 |ncParmBl|kPtr;...|
|000016b0| 09 09 7b 70 6f 69 6e 74 | 65 72 20 74 6f 20 61 73 |..{point|er to as|
|000016c0| 79 6e 63 68 20 7d 0d 09 | 09 09 7b 20 70 61 72 61 |ynch }..|..{ para|
|000016d0| 6d 65 74 65 72 20 62 6c | 6f 63 6b 7d 0d 09 73 65 |meter bl|ock}..se|
|000016e0| 73 73 49 44 3a 09 4c 6f | 6e 67 49 6e 74 3b 09 7b |ssID:.Lo|ngInt;.{|
|000016f0| 73 65 73 73 69 6f 6e 20 | 49 44 7d 0d 09 72 65 74 |session |ID}..ret|
|00001700| 75 72 6e 65 64 49 44 3a | 09 4c 6f 6e 67 49 6e 74 |urnedID:|.LongInt|
|00001710| 3b 09 7b 73 65 73 73 69 | 6f 6e 20 49 44 20 72 65 |;.{sessi|on ID re|
|00001720| 74 75 72 6e 65 64 7d 0d | 09 76 65 72 73 69 6f 6e |turned}.|.version|
|00001730| 3a 09 4c 6f 6e 67 49 6e | 74 3b 09 7b 76 65 72 73 |:.LongIn|t;.{vers|
|00001740| 69 6f 6e 20 6e 75 6d 62 | 65 72 7d 0d 09 73 74 61 |ion numb|er}..sta|
|00001750| 72 74 3a 09 4c 6f 6e 67 | 49 6e 74 3b 09 7b 73 65 |rt:.Long|Int;.{se|
|00001760| 73 73 69 6f 6e 20 73 74 | 61 72 74 20 74 69 6d 65 |ssion st|art time|
|00001770| 7d 0d 09 68 6f 73 74 3a | 09 53 74 72 69 6e 67 50 |}..host:|.StringP|
|00001780| 74 72 3b 09 7b 6e 61 6d | 65 20 6f 66 20 72 65 6d |tr;.{nam|e of rem|
|00001790| 6f 74 65 20 73 79 73 74 | 65 6d 7d 0d 09 75 73 65 |ote syst|em}..use|
|000017a0| 72 3a 09 53 74 72 69 6e | 67 50 74 72 3b 09 7b 75 |r:.Strin|gPtr;.{u|
|000017b0| 73 65 72 20 6e 61 6d 65 | 7d 0d 09 70 61 73 73 77 |ser name|}..passw|
|000017c0| 6f 72 64 3a 09 53 74 72 | 69 6e 67 50 74 72 3b 09 |ord:.Str|ingPtr;.|
|000017d0| 7b 75 73 65 72 20 70 61 | 73 73 77 6f 72 64 7d 0d |{user pa|ssword}.|
|000017e0| 09 63 6f 6e 6e 53 74 72 | 3a 09 53 74 72 69 6e 67 |.connStr|:.String|
|000017f0| 50 74 72 3b 09 7b 63 6f | 6e 6e 65 63 74 69 6f 6e |Ptr;.{co|nnection|
|00001800| 20 73 74 72 69 6e 67 7d | 0d 09 6e 65 74 77 6f 72 | string}|..networ|
|00001810| 6b 3a 09 53 74 72 69 6e | 67 50 74 72 3b 09 7b 6e |k:.Strin|gPtr;.{n|
|00001820| 61 6d 65 20 6f 66 20 74 | 68 65 20 6e 65 74 77 6f |ame of t|he netwo|
|00001830| 72 6b 7d 0d 09 62 75 66 | 66 65 72 3a 09 50 74 72 |rk}..buf|fer:.Ptr|
|00001840| 3b 09 7b 64 61 74 61 20 | 62 75 66 66 65 72 7d 0d |;.{data |buffer}.|
|00001850| 09 65 72 72 31 3a 09 4c | 6f 6e 67 49 6e 74 3b 09 |.err1:.L|ongInt;.|
|00001860| 7b 70 72 69 6d 61 72 79 | 20 65 72 72 6f 72 20 63 |{primary| error c|
|00001870| 6f 64 65 20 72 65 74 75 | 72 6e 65 64 7d 0d 09 65 |ode retu|rned}..e|
|00001880| 72 72 32 3a 09 4c 6f 6e | 67 49 6e 74 3b 09 7b 73 |rr2:.Lon|gInt;.{s|
|00001890| 65 63 6f 6e 64 61 72 79 | 20 65 72 72 6f 72 20 63 |econdary| error c|
|000018a0| 6f 64 65 20 7d 0d 09 09 | 09 7b 20 72 65 74 75 72 |ode }...|.{ retur|
|000018b0| 6e 65 64 7d 0d 09 69 74 | 65 6d 31 3a 09 53 74 72 |ned}..it|em1:.Str|
|000018c0| 69 6e 67 50 74 72 3b 09 | 7b 70 6f 69 6e 74 65 72 |ingPtr;.|{pointer|
|000018d0| 20 74 6f 20 6f 62 6a 65 | 63 74 20 6f 66 20 65 72 | to obje|ct of er|
|000018e0| 72 6f 72 20 7d 0d 09 09 | 09 7b 20 6d 65 73 73 61 |ror }...|.{ messa|
|000018f0| 67 65 7d 0d 09 69 74 65 | 6d 32 3a 09 53 74 72 69 |ge}..ite|m2:.Stri|
|00001900| 6e 67 50 74 72 3b 09 7b | 70 6f 69 6e 74 65 72 20 |ngPtr;.{|pointer |
|00001910| 74 6f 20 6f 62 6a 65 63 | 74 20 6f 66 20 7d 0d 09 |to objec|t of }..|
|00001920| 09 09 7b 20 65 72 72 6f | 72 20 6d 65 73 73 61 67 |..{ erro|r messag|
|00001930| 65 7d 0d 09 65 72 72 6f | 72 4d 73 67 3a 09 53 74 |e}..erro|rMsg:.St|
|00001940| 72 69 6e 67 50 74 72 3b | 09 7b 70 6f 69 6e 74 65 |ringPtr;|.{pointe|
|00001950| 72 20 74 6f 20 65 72 72 | 6f 72 20 6d 65 73 73 61 |r to err|or messa|
|00001960| 67 65 7d 0d 09 74 69 6d | 65 6f 75 74 3a 09 4c 6f |ge}..tim|eout:.Lo|
|00001970| 6e 67 49 6e 74 3b 09 7b | 74 69 6d 65 6f 75 74 20 |ngInt;.{|timeout |
|00001980| 76 61 6c 75 65 20 66 6f | 72 20 44 42 47 65 74 49 |value fo|r DBGetI|
|00001990| 74 65 6d 7d 0d 09 64 61 | 74 61 54 79 70 65 3a 09 |tem}..da|taType:.|
|000019a0| 44 42 54 79 70 65 3b 09 | 7b 64 61 74 61 20 74 79 |DBType;.|{data ty|
|000019b0| 70 65 7d 0d 09 73 65 73 | 73 4e 75 6d 3a 09 49 6e |pe}..ses|sNum:.In|
|000019c0| 74 65 67 65 72 3b 09 7b | 73 65 73 73 69 6f 6e 20 |teger;.{|session |
|000019d0| 6e 75 6d 62 65 72 7d 0d | 09 73 74 61 74 65 3a 09 |number}.|.state:.|
|000019e0| 49 6e 74 65 67 65 72 3b | 09 7b 73 74 61 74 75 73 |Integer;|.{status|
|000019f0| 20 6f 66 20 74 68 65 20 | 64 61 74 61 20 73 6f 75 | of the |data sou|
|00001a00| 72 63 65 7d 0d 09 6c 65 | 6e 3a 09 49 6e 74 65 67 |rce}..le|n:.Integ|
|00001a10| 65 72 3b 09 7b 6c 65 6e | 67 74 68 20 6f 66 20 64 |er;.{len|gth of d|
|00001a20| 61 74 61 20 69 74 65 6d | 7d 0d 09 70 6c 61 63 65 |ata item|}..place|
|00001a30| 73 3a 09 49 6e 74 65 67 | 65 72 3b 09 7b 64 65 63 |s:.Integ|er;.{dec|
|00001a40| 69 6d 61 6c 20 70 6c 61 | 63 65 73 20 69 6e 20 64 |imal pla|ces in d|
|00001a50| 61 74 61 20 69 74 65 6d | 7d 0d 09 66 6c 61 67 73 |ata item|}..flags|
|00001a60| 3a 09 49 6e 74 65 67 65 | 72 3b 09 7b 66 6c 61 67 |:.Intege|r;.{flag|
|00001a70| 73 7d 0d 09 61 62 6f 72 | 74 3a 09 42 6f 6f 6c 65 |s}..abor|t:.Boole|
|00001a80| 61 6e 09 7b 66 6c 61 67 | 20 66 6f 72 20 44 42 42 |an.{flag| for DBB|
|00001a90| 72 65 61 6b 7d 0d 45 4e | 44 3b 0d 46 69 65 6c 64 |reak}.EN|D;.Field|
|00001aa0| 20 44 65 73 63 72 69 70 | 74 69 6f 6e 73 0d 6d 65 | Descrip|tions.me|
|00001ab0| 73 73 61 67 65 09 54 68 | 65 20 72 6f 75 74 69 6e |ssage.Th|e routin|
|00001ac0| 65 20 73 65 6c 65 63 74 | 6f 72 20 74 68 61 74 20 |e select|or that |
|00001ad0| 74 65 6c 6c 73 20 74 68 | 65 20 64 61 74 61 20 61 |tells th|e data a|
|00001ae0| 63 63 65 73 73 20 65 78 | 74 65 6e 73 69 6f 6e 20 |ccess ex|tension |
|00001af0| 77 68 69 63 68 20 66 75 | 6e 63 74 69 6f 6e 20 74 |which fu|nction t|
|00001b00| 6f 20 65 78 65 63 75 74 | 65 2e 20 46 6f 72 20 74 |o execut|e. For t|
|00001b10| 68 65 20 76 61 6c 75 65 | 73 20 66 6f 72 20 74 68 |he value|s for th|
|00001b20| 69 73 20 66 69 65 6c 64 | 20 61 6e 64 20 64 65 73 |is field| and des|
|00001b30| 63 72 69 70 74 69 6f 6e | 73 20 6f 66 20 74 68 65 |cription|s of the|
|00001b40| 20 72 6f 75 74 69 6e 65 | 73 2c 20 73 65 65 20 74 | routine|s, see t|
|00001b50| 68 65 20 6e 65 78 74 20 | 73 65 63 74 69 6f 6e 2c |he next |section,|
|00001b60| 20 d2 44 61 74 61 20 41 | 63 63 65 73 73 20 45 78 | .Data A|ccess Ex|
|00001b70| 74 65 6e 73 69 6f 6e 20 | 4d 65 73 73 61 67 65 73 |tension |Messages|
|00001b80| 2e d3 09 0d 64 64 65 76 | 53 74 6f 72 61 67 65 09 |....ddev|Storage.|
|00001b90| 52 65 73 65 72 76 65 64 | 20 66 6f 72 20 75 73 65 |Reserved| for use|
|00001ba0| 20 62 79 20 74 68 65 20 | 64 61 74 61 20 61 63 63 | by the |data acc|
|00001bb0| 65 73 73 20 65 78 74 65 | 6e 73 69 6f 6e 2e 20 54 |ess exte|nsion. T|
|00001bc0| 68 65 20 44 61 74 61 20 | 41 63 63 65 73 73 20 4d |he Data |Access M|
|00001bd0| 61 6e 61 67 65 72 20 73 | 65 74 73 20 74 68 69 73 |anager s|ets this|
|00001be0| 20 66 69 65 6c 64 20 74 | 6f 20 30 20 77 68 65 6e | field t|o 0 when|
|00001bf0| 20 69 74 20 63 61 6c 6c | 73 20 74 68 65 20 64 61 | it call|s the da|
|00001c00| 74 61 20 61 63 63 65 73 | 73 20 65 78 74 65 6e 73 |ta acces|s extens|
|00001c10| 69 6f 6e 20 77 69 74 68 | 20 74 68 65 20 44 42 4f |ion with| the DBO|
|00001c20| 70 65 6e 20 6d 65 73 73 | 61 67 65 2e 20 54 68 65 |pen mess|age. The|
|00001c30| 20 64 61 74 61 20 61 63 | 63 65 73 73 20 65 78 74 | data ac|cess ext|
|00001c40| 65 6e 73 69 6f 6e 20 63 | 61 6e 20 73 74 6f 72 65 |ension c|an store|
|00001c50| 20 61 6e 79 20 76 61 6c | 75 65 20 69 6e 20 74 68 | any val|ue in th|
|00001c60| 69 73 20 66 69 65 6c 64 | 20 61 74 20 74 68 61 74 |is field| at that|
|00001c70| 20 74 69 6d 65 2c 20 61 | 6e 64 20 74 68 65 20 44 | time, a|nd the D|
|00001c80| 61 74 61 20 41 63 63 65 | 73 73 20 4d 61 6e 61 67 |ata Acce|ss Manag|
|00001c90| 65 72 20 72 65 74 61 69 | 6e 73 20 74 68 61 74 20 |er retai|ns that |
|00001ca0| 76 61 6c 75 65 20 6f 6e | 20 61 6c 6c 20 73 75 62 |value on| all sub|
|00001cb0| 73 65 71 75 65 6e 74 20 | 63 61 6c 6c 73 20 74 6f |sequent |calls to|
|00001cc0| 20 74 68 65 20 64 61 74 | 61 20 61 63 63 65 73 73 | the dat|a access|
|00001cd0| 20 65 78 74 65 6e 73 69 | 6f 6e 2e 20 54 68 65 20 | extensi|on. The |
|00001ce0| 76 61 6c 75 65 20 6f 66 | 20 74 68 69 73 20 66 69 |value of| this fi|
|00001cf0| 65 6c 64 20 64 6f 65 73 | 20 6e 6f 74 20 64 65 70 |eld does| not dep|
|00001d00| 65 6e 64 20 6f 6e 20 74 | 68 65 20 73 65 73 73 69 |end on t|he sessi|
|00001d10| 6f 6e 20 49 44 3b 20 69 | 74 20 69 73 20 74 68 65 |on ID; i|t is the|
|00001d20| 20 73 61 6d 65 20 66 6f | 72 20 61 6c 6c 20 73 65 | same fo|r all se|
|00001d30| 73 73 69 6f 6e 73 20 74 | 68 61 74 20 61 72 65 20 |ssions t|hat are |
|00001d40| 75 73 69 6e 67 20 74 68 | 65 20 73 61 6d 65 20 64 |using th|e same d|
|00001d50| 61 74 61 20 61 63 63 65 | 73 73 20 65 78 74 65 6e |ata acce|ss exten|
|00001d60| 73 69 6f 6e 2e 09 0d 61 | 73 79 6e 63 50 42 09 50 |sion...a|syncPB.P|
|00001d70| 6f 69 6e 74 65 72 20 74 | 6f 20 74 68 65 20 61 73 |ointer t|o the as|
|00001d80| 79 6e 63 68 72 6f 6e 6f | 75 73 20 70 61 72 61 6d |ynchrono|us param|
|00001d90| 65 74 65 72 20 62 6c 6f | 63 6b 2e 20 49 66 20 74 |eter blo|ck. If t|
|00001da0| 68 65 20 61 70 70 6c 69 | 63 61 74 69 6f 6e 20 69 |he appli|cation i|
|00001db0| 73 20 6d 61 6b 69 6e 67 | 20 61 20 73 79 6e 63 68 |s making| a synch|
|00001dc0| 72 6f 6e 6f 75 73 20 63 | 61 6c 6c 2c 20 74 68 69 |ronous c|all, thi|
|00001dd0| 73 20 66 69 65 6c 64 20 | 69 73 20 4e 49 4c 2e 20 |s field |is NIL. |
|00001de0| 54 68 65 20 61 73 79 6e | 63 68 72 6f 6e 6f 75 73 |The asyn|chronous|
|00001df0| 20 70 61 72 61 6d 65 74 | 65 72 20 62 6c 6f 63 6b | paramet|er block|
|00001e00| 20 69 73 20 64 65 73 63 | 72 69 62 65 64 20 69 6e | is desc|ribed in|
|00001e10| 20 d2 41 73 79 6e 63 68 | 72 6f 6e 6f 75 73 20 45 | .Asynch|ronous E|
|00001e20| 78 65 63 75 74 69 6f 6e | 20 6f 66 20 52 6f 75 74 |xecution| of Rout|
|00001e30| 69 6e 65 73 d3 20 69 6e | 20 74 68 65 20 44 61 74 |ines. in| the Dat|
|00001e40| 61 20 41 63 63 65 73 73 | 20 4d 61 6e 61 67 65 72 |a Access| Manager|
|00001e50| 20 63 68 61 70 74 65 72 | 20 6f 66 20 49 6e 73 69 | chapter| of Insi|
|00001e60| 64 65 20 4d 61 63 69 6e | 74 6f 73 68 20 56 6f 6c |de Macin|tosh Vol|
|00001e70| 75 6d 65 20 56 49 2e 20 | 09 0d 73 65 73 73 49 44 |ume VI. |..sessID|
|00001e80| 09 54 68 65 20 73 65 73 | 73 69 6f 6e 20 49 44 2e |.The ses|sion ID.|
|00001e90| 20 54 68 65 20 64 61 74 | 61 20 61 63 63 65 73 73 | The dat|a access|
|00001ea0| 20 65 78 74 65 6e 73 69 | 6f 6e 20 72 65 74 75 72 | extensi|on retur|
|00001eb0| 6e 73 20 74 68 65 20 73 | 65 73 73 69 6f 6e 20 49 |ns the s|ession I|
|00001ec0| 44 20 74 6f 20 74 68 65 | 20 44 42 49 6e 69 74 20 |D to the| DBInit |
|00001ed0| 66 75 6e 63 74 69 6f 6e | 3b 20 61 6c 6c 20 6f 74 |function|; all ot|
|00001ee0| 68 65 72 20 44 61 74 61 | 20 41 63 63 65 73 73 20 |her Data| Access |
|00001ef0| 4d 61 6e 61 67 65 72 20 | 66 75 6e 63 74 69 6f 6e |Manager |function|
|00001f00| 73 20 70 61 73 73 20 74 | 68 65 20 73 65 73 73 69 |s pass t|he sessi|
|00001f10| 6f 6e 20 49 44 20 74 6f | 20 74 68 65 20 64 61 74 |on ID to| the dat|
|00001f20| 61 20 61 63 63 65 73 73 | 20 65 78 74 65 6e 73 69 |a access| extensi|
|00001f30| 6f 6e 2e 20 0d 54 68 65 | 20 70 75 72 70 6f 73 65 |on. .The| purpose|
|00001f40| 20 6f 66 20 74 68 65 20 | 73 65 73 73 69 6f 6e 20 | of the |session |
|00001f50| 49 44 20 69 73 20 74 6f | 20 70 72 6f 76 69 64 65 |ID is to| provide|
|00001f60| 20 61 70 70 6c 69 63 61 | 74 69 6f 6e 73 20 77 69 | applica|tions wi|
|00001f70| 74 68 20 61 20 75 6e 69 | 71 75 65 20 69 64 65 6e |th a uni|que iden|
|00001f80| 74 69 66 69 65 72 20 66 | 6f 72 20 65 61 63 68 20 |tifier f|or each |
|00001f90| 61 63 74 69 76 65 20 73 | 65 73 73 69 6f 6e 2e 20 |active s|ession. |
|00001fa0| 54 68 65 20 44 61 74 61 | 20 41 63 63 65 73 73 20 |The Data| Access |
|00001fb0| 4d 61 6e 61 67 65 72 20 | 72 65 61 64 73 20 74 68 |Manager |reads th|
|00001fc0| 65 20 73 65 73 73 69 6f | 6e 20 49 44 20 72 65 74 |e sessio|n ID ret|
|00001fd0| 75 72 6e 65 64 20 62 79 | 20 74 68 65 20 64 61 74 |urned by| the dat|
|00001fe0| 61 20 61 63 63 65 73 73 | 20 65 78 74 65 6e 73 69 |a access| extensi|
|00001ff0| 6f 6e 2c 20 61 6e 64 20 | 74 68 65 6e 20 61 73 73 |on, and |then ass|
|00002000| 69 67 6e 73 20 61 20 75 | 6e 69 71 75 65 20 73 65 |igns a u|nique se|
|00002010| 73 73 69 6f 6e 20 49 44 | 20 74 6f 20 65 61 63 68 |ssion ID| to each|
|00002020| 20 73 65 73 73 69 6f 6e | 2e 20 54 68 65 20 44 61 | session|. The Da|
|00002030| 74 61 20 41 63 63 65 73 | 73 20 4d 61 6e 61 67 65 |ta Acces|s Manage|
|00002040| 72 20 70 65 72 66 6f 72 | 6d 73 20 74 68 65 20 6d |r perfor|ms the m|
|00002050| 61 70 70 69 6e 67 20 62 | 65 74 77 65 65 6e 20 74 |apping b|etween t|
|00002060| 68 65 20 73 65 73 73 69 | 6f 6e 20 49 44 73 20 74 |he sessi|on IDs t|
|00002070| 68 61 74 20 69 74 20 70 | 72 6f 76 69 64 65 73 20 |hat it p|rovides |
|00002080| 74 6f 20 61 70 70 6c 69 | 63 61 74 69 6f 6e 73 20 |to appli|cations |
|00002090| 61 6e 64 20 74 68 65 20 | 6f 6e 65 73 20 75 73 65 |and the |ones use|
|000020a0| 64 20 62 79 20 65 61 63 | 68 20 64 61 74 61 20 61 |d by eac|h data a|
|000020b0| 63 63 65 73 73 20 65 78 | 74 65 6e 73 69 6f 6e 2e |ccess ex|tension.|
|000020c0| 20 09 0d 72 65 74 75 72 | 6e 65 64 49 44 09 54 68 | ..retur|nedID.Th|
|000020d0| 65 20 73 65 73 73 69 6f | 6e 20 49 44 20 72 65 74 |e sessio|n ID ret|
|000020e0| 75 72 6e 65 64 20 62 79 | 20 74 68 65 20 44 42 47 |urned by| the DBG|
|000020f0| 65 74 43 6f 6e 6e 49 6e | 66 6f 20 66 75 6e 63 74 |etConnIn|fo funct|
|00002100| 69 6f 6e 2e 09 0d 76 65 | 72 73 69 6f 6e 09 54 68 |ion...ve|rsion.Th|
|00002110| 65 20 76 65 72 73 69 6f | 6e 20 6e 75 6d 62 65 72 |e versio|n number|
|00002120| 20 6f 66 20 74 68 65 20 | 64 61 74 61 20 61 63 63 | of the |data acc|
|00002130| 65 73 73 20 65 78 74 65 | 6e 73 69 6f 6e 20 61 73 |ess exte|nsion as|
|00002140| 73 69 67 6e 65 64 20 62 | 79 20 74 68 65 20 64 65 |signed b|y the de|
|00002150| 76 65 6c 6f 70 65 72 20 | 6f 66 20 74 68 65 20 64 |veloper |of the d|
|00002160| 61 74 61 20 61 63 63 65 | 73 73 20 65 78 74 65 6e |ata acce|ss exten|
|00002170| 73 69 6f 6e 2e 20 49 74 | 20 69 73 20 6e 6f 74 20 |sion. It| is not |
|00002180| 74 68 65 20 73 61 6d 65 | 20 61 73 20 74 68 65 20 |the same| as the |
|00002190| 76 65 72 73 69 6f 6e 20 | 6e 75 6d 62 65 72 20 69 |version |number i|
|000021a0| 6e 20 74 68 65 20 27 64 | 66 6c 67 27 20 72 65 73 |n the 'd|flg' res|
|000021b0| 6f 75 72 63 65 20 6f 66 | 20 74 68 65 20 64 61 74 |ource of| the dat|
|000021c0| 61 20 61 63 63 65 73 73 | 20 65 78 74 65 6e 73 69 |a access| extensi|
|000021d0| 6f 6e 2c 20 77 68 69 63 | 68 20 69 6e 64 69 63 61 |on, whic|h indica|
|000021e0| 74 65 73 20 74 68 65 20 | 66 6f 72 6d 61 74 20 6f |tes the |format o|
|000021f0| 66 20 74 68 65 20 64 61 | 74 61 20 61 63 63 65 73 |f the da|ta acces|
|00002200| 73 20 65 78 74 65 6e 73 | 69 6f 6e 2e 20 09 0d 73 |s extens|ion. ..s|
|00002210| 74 61 72 74 09 54 68 65 | 20 74 69 6d 65 20 61 74 |tart.The| time at|
|00002220| 20 77 68 69 63 68 20 74 | 68 65 20 73 65 73 73 69 | which t|he sessi|
|00002230| 6f 6e 20 77 61 73 20 6f | 70 65 6e 65 64 2c 20 69 |on was o|pened, i|
|00002240| 6e 20 74 69 63 6b 73 2e | 09 0d 68 6f 73 74 09 54 |n ticks.|..host.T|
|00002250| 68 65 20 6e 61 6d 65 20 | 6f 66 20 74 68 65 20 72 |he name |of the r|
|00002260| 65 6d 6f 74 65 20 73 79 | 73 74 65 6d 20 6f 6e 20 |emote sy|stem on |
|00002270| 77 68 69 63 68 20 74 68 | 65 20 64 61 74 61 20 73 |which th|e data s|
|00002280| 6f 75 72 63 65 20 69 73 | 20 6c 6f 63 61 74 65 64 |ource is| located|
|00002290| 2e 09 0d 75 73 65 72 09 | 54 68 65 20 6e 61 6d 65 |...user.|The name|
|000022a0| 20 6f 66 20 74 68 65 20 | 75 73 65 72 20 77 68 6f | of the |user who|
|000022b0| 20 69 73 20 65 73 74 61 | 62 6c 69 73 68 69 6e 67 | is esta|blishing|
|000022c0| 20 61 20 73 65 73 73 69 | 6f 6e 2e 09 0d 70 61 73 | a sessi|on...pas|
|000022d0| 73 77 6f 72 64 09 54 68 | 65 20 70 61 73 73 77 6f |sword.Th|e passwo|
|000022e0| 72 64 20 61 73 73 6f 63 | 69 61 74 65 64 20 77 69 |rd assoc|iated wi|
|000022f0| 74 68 20 74 68 65 20 75 | 73 65 72 20 6e 61 6d 65 |th the u|ser name|
|00002300| 2e 09 0d 63 6f 6e 6e 53 | 74 72 09 41 20 63 6f 6e |...connS|tr.A con|
|00002310| 6e 65 63 74 69 6f 6e 20 | 73 74 72 69 6e 67 20 6e |nection |string n|
|00002320| 65 65 64 65 64 20 74 6f | 20 65 73 74 61 62 6c 69 |eeded to| establi|
|00002330| 73 68 20 61 20 73 65 73 | 73 69 6f 6e 2e 09 0d 6e |sh a ses|sion...n|
|00002340| 65 74 77 6f 72 6b 09 41 | 20 73 74 72 69 6e 67 20 |etwork.A| string |
|00002350| 73 70 65 63 69 66 79 69 | 6e 67 20 74 68 65 20 6e |specifyi|ng the n|
|00002360| 65 74 77 6f 72 6b 20 69 | 6e 20 75 73 65 20 66 6f |etwork i|n use fo|
|00002370| 72 20 74 68 69 73 20 73 | 65 73 73 69 6f 6e 2e 09 |r this s|ession..|
|00002380| 0d 62 75 66 66 65 72 09 | 41 20 70 6f 69 6e 74 65 |.buffer.|A pointe|
|00002390| 72 20 74 6f 20 61 20 62 | 75 66 66 65 72 20 63 6f |r to a b|uffer co|
|000023a0| 6e 74 61 69 6e 69 6e 67 | 20 74 68 65 20 69 74 65 |ntaining| the ite|
|000023b0| 6d 20 74 6f 20 62 65 20 | 73 65 6e 74 20 62 79 20 |m to be |sent by |
|000023c0| 74 68 65 20 44 42 53 65 | 6e 64 20 6f 72 20 44 42 |the DBSe|nd or DB|
|000023d0| 53 65 6e 64 49 74 65 6d | 20 66 75 6e 63 74 69 6f |SendItem| functio|
|000023e0| 6e 73 20 6f 72 20 72 65 | 63 65 69 76 65 64 20 62 |ns or re|ceived b|
|000023f0| 79 20 74 68 65 20 44 42 | 47 65 74 49 74 65 6d 20 |y the DB|GetItem |
|00002400| 66 75 6e 63 74 69 6f 6e | 2e 20 09 0d 65 72 72 31 |function|. ..err1|
|00002410| 09 54 68 65 20 70 72 69 | 6d 61 72 79 20 65 72 72 |.The pri|mary err|
|00002420| 6f 72 20 63 6f 64 65 20 | 72 65 74 75 72 6e 65 64 |or code |returned|
|00002430| 20 62 79 20 74 68 65 20 | 64 61 74 61 20 73 6f 75 | by the |data sou|
|00002440| 72 63 65 2e 09 0d 65 72 | 72 32 09 54 68 65 20 73 |rce...er|r2.The s|
|00002450| 65 63 6f 6e 64 61 72 79 | 20 65 72 72 6f 72 20 63 |econdary| error c|
|00002460| 6f 64 65 20 72 65 74 75 | 72 6e 65 64 20 62 79 20 |ode retu|rned by |
|00002470| 74 68 65 20 64 61 74 61 | 20 73 6f 75 72 63 65 2e |the data| source.|
|00002480| 09 0d 69 74 65 6d 31 09 | 41 20 70 6f 69 6e 74 65 |..item1.|A pointe|
|00002490| 72 20 74 6f 20 61 20 4e | 55 4c 4c 2d 74 65 72 6d |r to a N|ULL-term|
|000024a0| 69 6e 61 74 65 64 20 73 | 74 72 69 6e 67 20 74 68 |inated s|tring th|
|000024b0| 61 74 20 69 64 65 6e 74 | 69 66 69 65 73 20 74 68 |at ident|ifies th|
|000024c0| 65 20 66 69 72 73 74 20 | 6f 62 6a 65 63 74 20 6f |e first |object o|
|000024d0| 66 20 74 68 65 20 65 72 | 72 6f 72 20 6d 65 73 73 |f the er|ror mess|
|000024e0| 61 67 65 20 72 65 74 75 | 72 6e 65 64 20 62 79 20 |age retu|rned by |
|000024f0| 74 68 65 20 64 61 74 61 | 20 73 6f 75 72 63 65 2e |the data| source.|
|00002500| 20 54 68 65 20 75 73 65 | 20 6f 66 20 74 68 69 73 | The use| of this|
|00002510| 20 70 61 72 61 6d 65 74 | 65 72 20 64 65 70 65 6e | paramet|er depen|
|00002520| 64 73 20 6f 6e 20 74 68 | 65 20 73 70 65 63 69 66 |ds on th|e specif|
|00002530| 69 63 20 64 61 74 61 20 | 73 6f 75 72 63 65 20 79 |ic data |source y|
|00002540| 6f 75 20 61 72 65 20 75 | 73 69 6e 67 2e 09 0d 69 |ou are u|sing...i|
|00002550| 74 65 6d 32 09 41 20 70 | 6f 69 6e 74 65 72 20 74 |tem2.A p|ointer t|
|00002560| 6f 20 61 20 4e 55 4c 4c | 2d 74 65 72 6d 69 6e 61 |o a NULL|-termina|
|00002570| 74 65 64 20 73 74 72 69 | 6e 67 20 74 68 61 74 20 |ted stri|ng that |
|00002580| 69 64 65 6e 74 69 66 69 | 65 73 20 74 68 65 20 73 |identifi|es the s|
|00002590| 65 63 6f 6e 64 20 6f 62 | 6a 65 63 74 20 6f 66 20 |econd ob|ject of |
|000025a0| 74 68 65 20 65 72 72 6f | 72 20 6d 65 73 73 61 67 |the erro|r messag|
|000025b0| 65 20 72 65 74 75 72 6e | 65 64 20 62 79 20 74 68 |e return|ed by th|
|000025c0| 65 20 64 61 74 61 20 73 | 6f 75 72 63 65 2e 20 54 |e data s|ource. T|
|000025d0| 68 65 20 75 73 65 20 6f | 66 20 74 68 69 73 20 70 |he use o|f this p|
|000025e0| 61 72 61 6d 65 74 65 72 | 20 64 65 70 65 6e 64 73 |arameter| depends|
|000025f0| 20 6f 6e 20 74 68 65 20 | 73 70 65 63 69 66 69 63 | on the |specific|
|00002600| 20 64 61 74 61 20 73 6f | 75 72 63 65 20 79 6f 75 | data so|urce you|
|00002610| 20 61 72 65 20 75 73 69 | 6e 67 2e 09 0d 65 72 72 | are usi|ng...err|
|00002620| 6f 72 4d 73 67 09 41 20 | 70 6f 69 6e 74 65 72 20 |orMsg.A |pointer |
|00002630| 74 6f 20 74 68 65 20 65 | 72 72 6f 72 20 6d 65 73 |to the e|rror mes|
|00002640| 73 61 67 65 20 72 65 74 | 75 72 6e 65 64 20 62 79 |sage ret|urned by|
|00002650| 20 74 68 65 20 64 61 74 | 61 20 73 6f 75 72 63 65 | the dat|a source|
|00002660| 2e 09 0d 74 69 6d 65 6f | 75 74 09 54 68 65 20 74 |...timeo|ut.The t|
|00002670| 69 6d 65 6f 75 74 20 70 | 65 72 69 6f 64 20 66 6f |imeout p|eriod fo|
|00002680| 72 20 74 68 65 20 44 42 | 47 65 74 49 74 65 6d 20 |r the DB|GetItem |
|00002690| 66 75 6e 63 74 69 6f 6e | 2c 20 69 6e 20 73 69 78 |function|, in six|
|000026a0| 74 69 65 74 68 73 20 6f | 66 20 73 65 63 6f 6e 64 |tieths o|f second|
|000026b0| 73 2e 20 57 68 65 6e 20 | 74 68 65 20 64 61 74 61 |s. When |the data|
|000026c0| 20 61 63 63 65 73 73 20 | 65 78 74 65 6e 73 69 6f | access |extensio|
|000026d0| 6e 20 65 78 65 63 75 74 | 65 73 20 74 68 65 20 44 |n execut|es the D|
|000026e0| 42 47 65 74 49 74 65 6d | 20 66 75 6e 63 74 69 6f |BGetItem| functio|
|000026f0| 6e 2c 20 69 74 20 72 65 | 71 75 65 73 74 73 20 61 |n, it re|quests a|
|00002700| 20 64 61 74 61 20 69 74 | 65 6d 20 66 72 6f 6d 20 | data it|em from |
|00002710| 74 68 65 20 72 65 6d 6f | 74 65 20 64 61 74 61 20 |the remo|te data |
|00002720| 73 6f 75 72 63 65 2e 20 | 49 66 20 74 68 65 20 72 |source. |If the r|
|00002730| 65 6d 6f 74 65 20 64 61 | 74 61 20 73 6f 75 72 63 |emote da|ta sourc|
|00002740| 65 20 64 6f 65 73 20 6e | 6f 74 20 72 65 74 75 72 |e does n|ot retur|
|00002750| 6e 20 74 68 65 20 72 65 | 71 75 65 73 74 65 64 20 |n the re|quested |
|00002760| 64 61 74 61 20 69 74 65 | 6d 20 69 6e 20 74 68 65 |data ite|m in the|
|00002770| 20 61 6d 6f 75 6e 74 20 | 6f 66 20 74 69 6d 65 20 | amount |of time |
|00002780| 73 70 65 63 69 66 69 65 | 64 20 62 79 20 74 68 65 |specifie|d by the|
|00002790| 20 74 69 6d 65 6f 75 74 | 20 70 61 72 61 6d 65 74 | timeout| paramet|
|000027a0| 65 72 2c 20 74 68 65 20 | 64 61 74 61 20 61 63 63 |er, the |data acc|
|000027b0| 65 73 73 20 65 78 74 65 | 6e 73 69 6f 6e 20 73 68 |ess exte|nsion sh|
|000027c0| 6f 75 6c 64 20 63 61 6e | 63 65 6c 20 65 78 65 63 |ould can|cel exec|
|000027d0| 75 74 69 6f 6e 20 6f 66 | 20 74 68 65 20 44 42 47 |ution of| the DBG|
|000027e0| 65 74 49 74 65 6d 20 66 | 75 6e 63 74 69 6f 6e 2e |etItem f|unction.|
|000027f0| 20 54 68 65 20 74 69 6d | 65 6f 75 74 20 76 61 6c | The tim|eout val|
|00002800| 75 65 20 63 61 6e 6e 6f | 74 20 62 65 20 75 73 65 |ue canno|t be use|
|00002810| 64 20 69 66 20 74 68 65 | 20 44 42 47 65 74 49 74 |d if the| DBGetIt|
|00002820| 65 6d 20 66 75 6e 63 74 | 69 6f 6e 20 69 73 20 63 |em funct|ion is c|
|00002830| 61 6c 6c 65 64 20 61 73 | 79 6e 63 68 72 6f 6e 6f |alled as|ynchrono|
|00002840| 75 73 6c 79 2e 20 09 0d | 64 61 74 61 54 79 70 65 |usly. ..|dataType|
|00002850| 09 54 68 65 20 64 61 74 | 61 20 74 79 70 65 20 6f |.The dat|a type o|
|00002860| 66 20 61 20 72 65 71 75 | 65 73 74 65 64 20 6f 72 |f a requ|ested or|
|00002870| 20 72 65 74 75 72 6e 65 | 64 20 64 61 74 61 20 69 | returne|d data i|
|00002880| 74 65 6d 2e 20 44 61 74 | 61 20 74 79 70 65 73 20 |tem. Dat|a types |
|00002890| 61 72 65 20 64 65 73 63 | 72 69 62 65 64 20 69 6e |are desc|ribed in|
|000028a0| 20 d2 47 65 74 74 69 6e | 67 20 51 75 65 72 79 20 | .Gettin|g Query |
|000028b0| 52 65 73 75 6c 74 73 d3 | 20 69 6e 20 74 68 65 20 |Results.| in the |
|000028c0| 44 61 74 61 20 41 63 63 | 65 73 73 20 4d 61 6e 61 |Data Acc|ess Mana|
|000028d0| 67 65 72 20 63 68 61 70 | 74 65 72 20 6f 66 20 49 |ger chap|ter of I|
|000028e0| 6e 73 69 64 65 20 4d 61 | 63 69 6e 74 6f 73 68 20 |nside Ma|cintosh |
|000028f0| 56 6f 6c 75 6d 65 20 56 | 49 2e 09 0d 73 65 73 73 |Volume V|I...sess|
|00002900| 4e 75 6d 09 54 68 65 20 | 73 65 73 73 69 6f 6e 20 |Num.The |session |
|00002910| 6e 75 6d 62 65 72 2e 20 | 54 68 69 73 20 6e 75 6d |number. |This num|
|00002920| 62 65 72 20 69 73 20 61 | 73 73 69 67 6e 65 64 20 |ber is a|ssigned |
|00002930| 62 79 20 74 68 65 20 64 | 61 74 61 20 61 63 63 65 |by the d|ata acce|
|00002940| 73 73 20 65 78 74 65 6e | 73 69 6f 6e 20 61 6e 64 |ss exten|sion and|
|00002950| 20 69 73 20 75 6e 69 71 | 75 65 20 66 6f 72 20 61 | is uniq|ue for a|
|00002960| 6c 6c 20 63 75 72 72 65 | 6e 74 20 73 65 73 73 69 |ll curre|nt sessi|
|00002970| 6f 6e 73 20 66 6f 72 20 | 61 20 73 69 6e 67 6c 65 |ons for |a single|
|00002980| 20 64 61 74 61 20 61 63 | 63 65 73 73 20 65 78 74 | data ac|cess ext|
|00002990| 65 6e 73 69 6f 6e 20 6f | 6e 6c 79 2e 20 54 68 65 |ension o|nly. The|
|000029a0| 20 73 61 6d 65 20 73 65 | 73 73 69 6f 6e 20 6e 75 | same se|ssion nu|
|000029b0| 6d 62 65 72 20 63 61 6e | 20 62 65 20 61 73 73 69 |mber can| be assi|
|000029c0| 67 6e 65 64 20 74 6f 20 | 63 6f 6e 63 75 72 72 65 |gned to |concurre|
|000029d0| 6e 74 20 73 65 73 73 69 | 6f 6e 73 20 74 68 61 74 |nt sessi|ons that|
|000029e0| 20 75 73 65 20 64 69 66 | 66 65 72 65 6e 74 20 64 | use dif|ferent d|
|000029f0| 61 74 61 20 61 63 63 65 | 73 73 20 65 78 74 65 6e |ata acce|ss exten|
|00002a00| 73 69 6f 6e 73 2e 09 0d | 73 74 61 74 65 09 54 68 |sions...|state.Th|
|00002a10| 65 20 73 74 61 74 75 73 | 20 6f 66 20 74 68 65 20 |e status| of the |
|00002a20| 64 61 74 61 20 73 6f 75 | 72 63 65 2e 0d 56 61 6c |data sou|rce..Val|
|00002a30| 75 65 09 53 74 61 74 75 | 73 0d 6e 6f 45 72 72 20 |ue.Statu|s.noErr |
|00002a40| 20 09 45 78 65 63 75 74 | 69 6f 6e 20 6f 66 20 61 | .Execut|ion of a|
|00002a50| 20 71 75 65 72 79 20 73 | 75 63 63 65 73 73 66 75 | query s|uccessfu|
|00002a60| 6c 3b 20 72 65 61 64 79 | 20 66 6f 72 20 61 6e 6f |l; ready| for ano|
|00002a70| 74 68 65 72 0d 72 63 44 | 42 56 61 6c 75 65 09 4f |ther.rcD|BValue.O|
|00002a80| 75 74 70 75 74 20 64 61 | 74 61 20 69 73 20 61 76 |utput da|ta is av|
|00002a90| 61 69 6c 61 62 6c 65 0d | 72 63 44 42 45 72 72 6f |ailable.|rcDBErro|
|00002aa0| 72 09 45 78 65 63 75 74 | 69 6f 6e 20 6f 66 20 61 |r.Execut|ion of a|
|00002ab0| 20 71 75 65 72 79 20 65 | 6e 64 65 64 20 69 6e 20 | query e|nded in |
|00002ac0| 61 6e 20 65 72 72 6f 72 | 0d 72 63 44 42 45 78 65 |an error|.rcDBExe|
|00002ad0| 63 09 43 75 72 72 65 6e | 74 6c 79 20 65 78 65 63 |c.Curren|tly exec|
|00002ae0| 75 74 69 6e 67 20 61 20 | 71 75 65 72 79 09 0d 6c |uting a |query..l|
|00002af0| 65 6e 09 54 68 65 20 6c | 65 6e 67 74 68 20 6f 66 |en.The l|ength of|
|00002b00| 20 74 68 65 20 64 61 74 | 61 20 69 74 65 6d 20 72 | the dat|a item r|
|00002b10| 65 71 75 65 73 74 65 64 | 20 6f 72 20 72 65 74 75 |equested| or retu|
|00002b20| 72 6e 65 64 2e 09 0d 70 | 6c 61 63 65 73 09 54 68 |rned...p|laces.Th|
|00002b30| 65 20 6e 75 6d 62 65 72 | 20 6f 66 20 64 65 63 69 |e number| of deci|
|00002b40| 6d 61 6c 20 70 6c 61 63 | 65 73 20 69 6e 20 74 68 |mal plac|es in th|
|00002b50| 65 20 64 61 74 61 20 69 | 74 65 6d 2e 09 0d 66 6c |e data i|tem...fl|
|00002b60| 61 67 73 09 46 6c 61 67 | 73 20 72 65 74 75 72 6e |ags.Flag|s return|
|00002b70| 65 64 20 62 79 20 74 68 | 65 20 44 42 47 65 74 49 |ed by th|e DBGetI|
|00002b80| 74 65 6d 20 66 75 6e 63 | 74 69 6f 6e 20 6f 72 20 |tem func|tion or |
|00002b90| 73 65 6e 74 20 74 6f 20 | 74 68 65 20 44 42 53 65 |sent to |the DBSe|
|00002ba0| 6e 64 49 74 65 6d 20 66 | 75 6e 63 74 69 6f 6e 2e |ndItem f|unction.|
|00002bb0| 20 46 6f 72 20 74 68 65 | 20 44 42 47 65 74 49 74 | For the| DBGetIt|
|00002bc0| 65 6d 20 66 75 6e 63 74 | 69 6f 6e 2c 20 69 66 20 |em funct|ion, if |
|00002bd0| 74 68 65 20 66 6c 61 67 | 73 20 66 69 65 6c 64 20 |the flag|s field |
|00002be0| 69 73 20 73 65 74 20 74 | 6f 20 6b 44 42 4c 61 73 |is set t|o kDBLas|
|00002bf0| 74 43 6f 6c 46 6c 61 67 | 20 28 74 68 61 74 20 69 |tColFlag| (that i|
|00002c00| 73 2c 20 74 68 65 20 6c | 65 61 73 74 20 73 69 67 |s, the l|east sig|
|00002c10| 6e 69 66 69 63 61 6e 74 | 20 62 69 74 20 69 73 20 |nificant| bit is |
|00002c20| 73 65 74 20 74 6f 20 31 | 29 2c 20 74 68 65 20 64 |set to 1|), the d|
|00002c30| 61 74 61 20 69 74 65 6d | 20 69 73 20 69 6e 20 74 |ata item| is in t|
|00002c40| 68 65 20 6c 61 73 74 20 | 63 6f 6c 75 6d 6e 20 6f |he last |column o|
|00002c50| 66 20 74 68 65 20 72 6f | 77 2e 20 0d 54 68 65 72 |f the ro|w. .Ther|
|00002c60| 65 20 61 72 65 20 6e 6f | 20 66 6c 61 67 73 20 63 |e are no| flags c|
|00002c70| 75 72 72 65 6e 74 6c 79 | 20 64 65 66 69 6e 65 64 |urrently| defined|
|00002c80| 20 66 6f 72 20 74 68 65 | 20 44 42 53 65 6e 64 49 | for the| DBSendI|
|00002c90| 74 65 6d 20 66 75 6e 63 | 74 69 6f 6e 2e 20 09 0d |tem func|tion. ..|
|00002ca0| 61 62 6f 72 74 09 41 20 | 70 61 72 61 6d 65 74 65 |abort.A |paramete|
|00002cb0| 72 20 75 73 65 64 20 62 | 79 20 74 68 65 20 44 42 |r used b|y the DB|
|00002cc0| 42 72 65 61 6b 20 66 75 | 6e 63 74 69 6f 6e 2e 20 |Break fu|nction. |
|00002cd0| 54 68 65 20 6d 65 61 6e | 69 6e 67 20 6f 66 20 74 |The mean|ing of t|
|00002ce0| 68 69 73 20 70 61 72 61 | 6d 65 74 65 72 20 64 65 |his para|meter de|
|00002cf0| 70 65 6e 64 73 20 6f 6e | 20 74 68 65 20 73 70 65 |pends on| the spe|
|00002d00| 63 69 66 69 63 20 69 6d | 70 6c 65 6d 65 6e 74 61 |cific im|plementa|
|00002d10| 74 69 6f 6e 20 6f 66 20 | 74 68 65 20 64 61 74 61 |tion of |the data|
|00002d20| 20 73 6f 75 72 63 65 20 | 63 6f 6d 6d 75 6e 69 63 | source |communic|
|00002d30| 61 74 69 6f 6e 73 20 73 | 79 73 74 65 6d 20 79 6f |ations s|ystem yo|
|00002d40| 75 20 61 72 65 20 75 73 | 69 6e 67 2e 09 0d 09 09 |u are us|ing.....|
|00002d50| 0d 0d 44 61 74 61 20 41 | 63 63 65 73 73 20 45 78 |..Data A|ccess Ex|
|00002d60| 74 65 6e 73 69 6f 6e 20 | 4d 65 73 73 61 67 65 73 |tension |Messages|
|00002d70| 0d 54 68 65 72 65 20 61 | 72 65 20 73 69 78 74 65 |.There a|re sixte|
|00002d80| 65 6e 20 76 61 6c 75 65 | 73 20 74 68 61 74 20 74 |en value|s that t|
|00002d90| 68 65 20 44 61 74 61 20 | 41 63 63 65 73 73 20 4d |he Data |Access M|
|00002da0| 61 6e 61 67 65 72 20 63 | 61 6e 20 70 61 73 73 20 |anager c|an pass |
|00002db0| 74 6f 20 74 68 65 20 64 | 61 74 61 20 61 63 63 65 |to the d|ata acce|
|00002dc0| 73 73 20 65 78 74 65 6e | 73 69 6f 6e 20 69 6e 20 |ss exten|sion in |
|00002dd0| 74 68 65 20 6d 65 73 73 | 61 67 65 73 20 66 69 65 |the mess|ages fie|
|00002de0| 6c 64 20 6f 66 20 74 68 | 65 20 64 61 74 61 20 61 |ld of th|e data a|
|00002df0| 63 63 65 73 73 20 65 78 | 74 65 6e 73 69 6f 6e 20 |ccess ex|tension |
|00002e00| 70 61 72 61 6d 65 74 65 | 72 20 62 6c 6f 63 6b 2e |paramete|r block.|
|00002e10| 20 54 68 69 72 74 65 65 | 6e 20 6f 66 20 74 68 65 | Thirtee|n of the|
|00002e20| 6d 20 63 6f 72 72 65 73 | 70 6f 6e 64 20 65 78 61 |m corres|pond exa|
|00002e30| 63 74 6c 79 20 74 6f 20 | 74 68 65 20 74 68 69 72 |ctly to |the thir|
|00002e40| 74 65 65 6e 20 6c 6f 77 | 2d 6c 65 76 65 6c 20 66 |teen low|-level f|
|00002e50| 75 6e 63 74 69 6f 6e 73 | 2e 20 54 68 65 20 6f 74 |unctions|. The ot|
|00002e60| 68 65 72 20 74 68 72 65 | 65 20 61 72 65 20 75 73 |her thre|e are us|
|00002e70| 65 64 20 62 79 20 74 68 | 65 20 44 61 74 61 20 41 |ed by th|e Data A|
|00002e80| 63 63 65 73 73 20 4d 61 | 6e 61 67 65 72 20 74 6f |ccess Ma|nager to|
|00002e90| 20 69 6e 69 74 69 61 6c | 69 7a 65 20 61 6e 64 20 | initial|ize and |
|00002ea0| 63 6c 6f 73 65 20 74 68 | 65 20 64 61 74 61 20 61 |close th|e data a|
|00002eb0| 63 63 65 73 73 20 65 78 | 74 65 6e 73 69 6f 6e 20 |ccess ex|tension |
|00002ec0| 61 6e 64 20 74 6f 20 61 | 6c 6c 6f 77 20 74 68 65 |and to a|llow the|
|00002ed0| 20 64 61 74 61 20 61 63 | 63 65 73 73 20 65 78 74 | data ac|cess ext|
|00002ee0| 65 6e 73 69 6f 6e 20 74 | 6f 20 70 65 72 66 6f 72 |ension t|o perfor|
|00002ef0| 6d 20 72 6f 75 74 69 6e | 65 20 70 65 72 69 6f 64 |m routin|e period|
|00002f00| 69 63 20 74 61 73 6b 73 | 2e 20 54 68 65 20 6d 65 |ic tasks|. The me|
|00002f10| 73 73 61 67 65 73 20 74 | 68 61 74 20 63 6f 72 72 |ssages t|hat corr|
|00002f20| 65 73 70 6f 6e 64 20 74 | 6f 20 6c 6f 77 2d 6c 65 |espond t|o low-le|
|00002f30| 76 65 6c 20 72 6f 75 74 | 69 6e 65 73 20 61 72 65 |vel rout|ines are|
|00002f40| 20 6e 6f 74 20 64 65 73 | 63 72 69 62 65 64 20 69 | not des|cribed i|
|00002f50| 6e 20 74 68 69 73 20 73 | 65 63 74 69 6f 6e 2e 20 |n this s|ection. |
|00002f60| 49 6e 73 74 65 61 64 2c | 20 6f 6e 6c 79 20 74 68 |Instead,| only th|
|00002f70| 65 20 70 61 72 61 6d 65 | 74 65 72 73 20 74 68 65 |e parame|ters the|
|00002f80| 79 20 75 73 65 20 61 6e | 64 20 74 68 65 20 72 65 |y use an|d the re|
|00002f90| 73 75 6c 74 20 63 6f 64 | 65 73 20 74 68 65 79 20 |sult cod|es they |
|00002fa0| 6d 75 73 74 20 62 65 20 | 61 62 6c 65 20 74 6f 20 |must be |able to |
|00002fb0| 72 65 74 75 72 6e 20 61 | 72 65 20 6c 69 73 74 65 |return a|re liste|
|00002fc0| 64 2e 20 46 6f 72 20 64 | 65 73 63 72 69 70 74 69 |d. For d|escripti|
|00002fd0| 6f 6e 73 20 6f 66 20 74 | 68 65 73 65 20 72 6f 75 |ons of t|hese rou|
|00002fe0| 74 69 6e 65 73 2c 20 73 | 65 65 20 74 68 65 20 73 |tines, s|ee the s|
|00002ff0| 65 63 74 69 6f 6e 20 d2 | 44 61 74 61 20 41 63 63 |ection .|Data Acc|
|00003000| 65 73 73 20 4d 61 6e 61 | 67 65 72 20 52 6f 75 74 |ess Mana|ger Rout|
|00003010| 69 6e 65 73 d3 20 69 6e | 20 74 68 65 20 44 61 74 |ines. in| the Dat|
|00003020| 61 20 41 63 63 65 73 73 | 20 4d 61 6e 61 67 65 72 |a Access| Manager|
|00003030| 20 63 68 61 70 74 65 72 | 20 6f 66 20 49 6e 73 69 | chapter| of Insi|
|00003040| 64 65 20 4d 61 63 69 6e | 74 6f 73 68 20 56 6f 6c |de Macin|tosh Vol|
|00003050| 75 6d 65 20 56 49 2e 20 | 54 68 65 20 44 42 4f 70 |ume VI. |The DBOp|
|00003060| 65 6e 2c 20 44 42 43 6c | 6f 73 65 2c 20 61 6e 64 |en, DBCl|ose, and|
|00003070| 20 44 42 49 64 6c 65 20 | 6d 65 73 73 61 67 65 73 | DBIdle |messages|
|00003080| 20 61 72 65 20 64 65 73 | 63 72 69 62 65 64 20 69 | are des|cribed i|
|00003090| 6e 20 64 65 74 61 69 6c | 20 69 6e 20 74 68 69 73 |n detail| in this|
|000030a0| 20 73 65 63 74 69 6f 6e | 2e 0d 45 61 63 68 20 70 | section|..Each p|
|000030b0| 61 72 61 6d 65 74 65 72 | 20 69 6e 20 74 68 65 20 |arameter| in the |
|000030c0| 6c 69 73 74 20 69 73 20 | 70 72 65 63 65 64 65 64 |list is |preceded|
|000030d0| 20 62 79 20 61 6e 20 61 | 72 72 6f 77 20 74 68 61 | by an a|rrow tha|
|000030e0| 74 20 69 6e 64 69 63 61 | 74 65 73 20 68 6f 77 20 |t indica|tes how |
|000030f0| 74 68 65 20 70 61 72 61 | 6d 65 74 65 72 20 69 73 |the para|meter is|
|00003100| 20 75 73 65 64 2c 20 61 | 73 20 66 6f 6c 6c 6f 77 | used, a|s follow|
|00003110| 73 3a 0d ae 09 54 68 65 | 20 44 61 74 61 20 41 63 |s:...The| Data Ac|
|00003120| 63 65 73 73 20 4d 61 6e | 61 67 65 72 20 70 61 73 |cess Man|ager pas|
|00003130| 73 65 73 20 74 68 65 20 | 76 61 6c 75 65 20 6f 66 |ses the |value of|
|00003140| 20 74 68 65 20 70 61 72 | 61 6d 65 74 65 72 20 61 | the par|ameter a|
|00003150| 73 20 69 6e 70 75 74 20 | 74 6f 20 74 68 65 20 64 |s input |to the d|
|00003160| 61 74 61 20 61 63 63 65 | 73 73 20 65 78 74 65 6e |ata acce|ss exten|
|00003170| 73 69 6f 6e 2e 0d ac 09 | 54 68 65 20 64 61 74 61 |sion....|The data|
|00003180| 20 61 63 63 65 73 73 20 | 65 78 74 65 6e 73 69 6f | access |extensio|
|00003190| 6e 20 72 65 74 75 72 6e | 73 20 74 68 65 20 76 61 |n return|s the va|
|000031a0| 6c 75 65 20 6f 66 20 74 | 68 65 20 70 61 72 61 6d |lue of t|he param|
|000031b0| 65 74 65 72 20 61 66 74 | 65 72 20 74 68 65 20 72 |eter aft|er the r|
|000031c0| 6f 75 74 69 6e 65 20 68 | 61 73 20 63 6f 6d 70 6c |outine h|as compl|
|000031d0| 65 74 65 64 20 65 78 65 | 63 75 74 69 6f 6e 2e 0d |eted exe|cution..|
|000031e0| ab 09 54 68 65 20 44 61 | 74 61 20 41 63 63 65 73 |..The Da|ta Acces|
|000031f0| 73 20 4d 61 6e 61 67 65 | 72 20 70 72 6f 76 69 64 |s Manage|r provid|
|00003200| 65 73 20 61 20 76 61 6c | 75 65 20 66 6f 72 20 74 |es a val|ue for t|
|00003210| 68 65 20 70 61 72 61 6d | 65 74 65 72 2c 20 61 6e |he param|eter, an|
|00003220| 64 20 74 68 65 20 64 61 | 74 61 20 61 63 63 65 73 |d the da|ta acces|
|00003230| 73 20 65 78 74 65 6e 73 | 69 6f 6e 20 72 65 74 75 |s extens|ion retu|
|00003240| 72 6e 73 20 61 6e 6f 74 | 68 65 72 20 76 61 6c 75 |rns anot|her valu|
|00003250| 65 2e 0d 44 42 4f 70 65 | 6e 0d 50 61 72 61 6d 65 |e..DBOpe|n.Parame|
|00003260| 74 65 72 20 62 6c 6f 63 | 6b 0d 09 ae 09 30 30 09 |ter bloc|k....00.|
|00003270| 6d 65 73 73 61 67 65 09 | 77 6f 72 64 09 72 6f 75 |message.|word.rou|
|00003280| 74 69 6e 65 20 73 65 6c | 65 63 74 6f 72 3b 20 6b |tine sel|ector; k|
|00003290| 44 42 4f 70 65 6e 0d 09 | ac 09 30 32 09 64 64 65 |DBOpen..|..02.dde|
|000032a0| 76 53 74 6f 72 61 67 65 | 09 6c 6f 6e 67 20 09 73 |vStorage|.long .s|
|000032b0| 74 6f 72 61 67 65 20 66 | 6f 72 20 64 61 74 61 20 |torage f|or data |
|000032c0| 61 63 63 65 73 73 20 09 | 09 09 09 09 09 65 78 74 |access .|.....ext|
|000032d0| 65 6e 73 69 6f 6e 0d 57 | 68 65 6e 20 61 6e 20 61 |ension.W|hen an a|
|000032e0| 70 70 6c 69 63 61 74 69 | 6f 6e 20 63 61 6c 6c 73 |pplicati|on calls|
|000032f0| 20 74 68 65 20 44 42 49 | 6e 69 74 20 66 75 6e 63 | the DBI|nit func|
|00003300| 74 69 6f 6e 20 6f 72 20 | 74 68 65 20 44 42 53 74 |tion or |the DBSt|
|00003310| 61 72 74 51 75 65 72 79 | 20 66 75 6e 63 74 69 6f |artQuery| functio|
|00003320| 6e 20 28 77 68 69 63 68 | 20 63 61 6c 6c 73 20 74 |n (which| calls t|
|00003330| 68 65 20 44 42 49 6e 69 | 74 20 66 75 6e 63 74 69 |he DBIni|t functi|
|00003340| 6f 6e 29 2c 20 69 74 20 | 73 70 65 63 69 66 69 65 |on), it |specifie|
|00003350| 73 20 61 20 64 61 74 61 | 20 61 63 63 65 73 73 20 |s a data| access |
|00003360| 65 78 74 65 6e 73 69 6f | 6e 2e 20 49 66 20 74 68 |extensio|n. If th|
|00003370| 61 74 20 64 61 74 61 20 | 61 63 63 65 73 73 20 65 |at data |access e|
|00003380| 78 74 65 6e 73 69 6f 6e | 20 69 73 20 6e 6f 74 20 |xtension| is not |
|00003390| 61 6c 72 65 61 64 79 20 | 69 6e 20 6d 65 6d 6f 72 |already |in memor|
|000033a0| 79 2c 20 74 68 65 20 44 | 42 49 6e 69 74 20 66 75 |y, the D|BInit fu|
|000033b0| 6e 63 74 69 6f 6e 20 6c | 6f 61 64 73 20 69 74 20 |nction l|oads it |
|000033c0| 69 6e 74 6f 20 6d 65 6d | 6f 72 79 20 61 6e 64 20 |into mem|ory and |
|000033d0| 73 65 6e 64 73 20 69 74 | 20 74 68 65 20 6b 44 42 |sends it| the kDB|
|000033e0| 4f 70 65 6e 20 6d 65 73 | 73 61 67 65 2e 20 54 68 |Open mes|sage. Th|
|000033f0| 65 20 64 61 74 61 20 61 | 63 63 65 73 73 20 65 78 |e data a|ccess ex|
|00003400| 74 65 6e 73 69 6f 6e 20 | 73 68 6f 75 6c 64 20 61 |tension |should a|
|00003410| 6c 6c 6f 63 61 74 65 20 | 61 6e 79 20 6d 65 6d 6f |llocate |any memo|
|00003420| 72 79 20 69 74 20 6e 65 | 65 64 73 20 61 74 20 74 |ry it ne|eds at t|
|00003430| 68 69 73 20 74 69 6d 65 | 2e 20 42 65 63 61 75 73 |his time|. Becaus|
|00003440| 65 20 74 68 65 20 64 61 | 74 61 20 61 63 63 65 73 |e the da|ta acces|
|00003450| 73 20 65 78 74 65 6e 73 | 69 6f 6e 20 63 61 6e 20 |s extens|ion can |
|00003460| 62 65 20 63 61 6c 6c 65 | 64 20 62 79 20 6d 6f 72 |be calle|d by mor|
|00003470| 65 20 74 68 61 6e 20 6f | 6e 65 20 61 70 70 6c 69 |e than o|ne appli|
|00003480| 63 61 74 69 6f 6e 2c 20 | 69 74 20 73 68 6f 75 6c |cation, |it shoul|
|00003490| 64 20 61 6c 6c 6f 63 61 | 74 65 20 6d 65 6d 6f 72 |d alloca|te memor|
|000034a0| 79 20 69 6e 20 74 68 65 | 20 73 79 73 74 65 6d 20 |y in the| system |
|000034b0| 68 65 61 70 20 72 61 74 | 68 65 72 20 74 68 61 6e |heap rat|her than|
|000034c0| 20 74 68 65 20 61 70 70 | 6c 69 63 61 74 69 6f 6e | the app|lication|
|000034d0| 20 68 65 61 70 2e 20 54 | 68 65 20 64 61 74 61 20 | heap. T|he data |
|000034e0| 61 63 63 65 73 73 20 65 | 78 74 65 6e 73 69 6f 6e |access e|xtension|
|000034f0| 20 63 61 6e 20 61 6c 73 | 6f 20 72 65 74 75 72 6e | can als|o return|
|00003500| 20 61 20 76 61 6c 75 65 | 20 69 6e 20 74 68 65 20 | a value| in the |
|00003510| 64 64 65 76 53 74 6f 72 | 61 67 65 20 66 69 65 6c |ddevStor|age fiel|
|00003520| 64 20 6f 66 20 74 68 65 | 20 64 61 74 61 20 61 63 |d of the| data ac|
|00003530| 63 65 73 73 20 65 78 74 | 65 6e 73 69 6f 6e 20 70 |cess ext|ension p|
|00003540| 61 72 61 6d 65 74 65 72 | 20 62 6c 6f 63 6b 2e 20 |arameter| block. |
|00003550| 0d 57 68 65 6e 20 74 68 | 65 20 44 61 74 61 20 41 |.When th|e Data A|
|00003560| 63 63 65 73 73 20 4d 61 | 6e 61 67 65 72 20 63 61 |ccess Ma|nager ca|
|00003570| 6c 6c 73 20 74 68 65 20 | 64 61 74 61 20 61 63 63 |lls the |data acc|
|00003580| 65 73 73 20 65 78 74 65 | 6e 73 69 6f 6e 2c 20 74 |ess exte|nsion, t|
|00003590| 68 65 20 63 75 72 72 65 | 6e 74 20 72 65 73 6f 75 |he curre|nt resou|
|000035a0| 72 63 65 20 66 69 6c 65 | 20 69 73 20 74 68 65 20 |rce file| is the |
|000035b0| 64 61 74 61 20 61 63 63 | 65 73 73 20 65 78 74 65 |data acc|ess exte|
|000035c0| 6e 73 69 6f 6e 20 66 69 | 6c 65 20 61 6e 64 20 74 |nsion fi|le and t|
|000035d0| 68 65 20 64 65 66 61 75 | 6c 74 20 64 69 72 65 63 |he defau|lt direc|
|000035e0| 74 6f 72 79 20 69 73 20 | 74 68 65 20 45 78 74 65 |tory is |the Exte|
|000035f0| 6e 73 69 6f 6e 73 20 46 | 6f 6c 64 65 72 20 6f 6e |nsions F|older on|
|00003600| 20 74 68 65 20 63 75 72 | 72 65 6e 74 20 73 74 61 | the cur|rent sta|
|00003610| 72 74 75 70 20 64 69 73 | 6b 2e 20 54 68 65 20 64 |rtup dis|k. The d|
|00003620| 61 74 61 20 61 63 63 65 | 73 73 20 65 78 74 65 6e |ata acce|ss exten|
|00003630| 73 69 6f 6e 20 6d 75 73 | 74 20 65 6e 73 75 72 65 |sion mus|t ensure|
|00003640| 20 74 68 61 74 20 62 6f | 74 68 20 6f 66 20 74 68 | that bo|th of th|
|00003650| 65 73 65 20 76 61 6c 75 | 65 73 20 61 72 65 20 75 |ese valu|es are u|
|00003660| 6e 63 68 61 6e 67 65 64 | 20 77 68 65 6e 20 69 74 |nchanged| when it|
|00003670| 20 72 65 74 75 72 6e 73 | 20 63 6f 6e 74 72 6f 6c | returns| control|
|00003680| 20 74 6f 20 74 68 65 20 | 44 61 74 61 20 41 63 63 | to the |Data Acc|
|00003690| 65 73 73 20 4d 61 6e 61 | 67 65 72 2e 0d 52 65 73 |ess Mana|ger..Res|
|000036a0| 75 6c 74 20 63 6f 64 65 | 73 0d 6e 6f 45 72 72 20 |ult code|s.noErr |
|000036b0| 20 20 20 20 20 20 20 20 | 30 09 44 61 74 61 20 41 | |0.Data A|
|000036c0| 63 63 65 73 73 20 45 78 | 74 65 6e 73 69 6f 6e 20 |ccess Ex|tension |
|000036d0| 69 6e 69 74 69 61 6c 69 | 7a 65 64 20 73 75 63 63 |initiali|zed succ|
|000036e0| 65 73 73 66 75 6c 6c 79 | 0d 72 63 44 42 45 72 72 |essfully|.rcDBErr|
|000036f0| 6f 72 09 d0 20 20 20 20 | d0 38 30 32 09 45 72 72 |or.. |.802.Err|
|00003700| 6f 72 20 69 6e 69 74 69 | 61 6c 69 7a 69 6e 67 20 |or initi|alizing |
|00003710| 64 61 74 61 20 61 63 63 | 65 73 73 20 65 78 74 65 |data acc|ess exte|
|00003720| 6e 73 69 6f 6e 0d 44 42 | 43 6c 6f 73 65 0d 50 61 |nsion.DB|Close.Pa|
|00003730| 72 61 6d 65 74 65 72 20 | 62 6c 6f 63 6b 0d 09 ae |rameter |block...|
|00003740| 09 30 30 09 6d 65 73 73 | 61 67 65 09 77 6f 72 64 |.00.mess|age.word|
|00003750| 09 72 6f 75 74 69 6e 65 | 20 73 65 6c 65 63 74 6f |.routine| selecto|
|00003760| 72 3b 20 6b 44 42 43 6c | 6f 73 65 0d 09 ae 09 30 |r; kDBCl|ose....0|
|00003770| 32 09 64 64 65 76 53 74 | 6f 72 61 67 65 09 6c 6f |2.ddevSt|orage.lo|
|00003780| 6e 67 20 09 73 74 6f 72 | 61 67 65 20 66 6f 72 20 |ng .stor|age for |
|00003790| 64 61 74 61 20 61 63 63 | 65 73 73 20 65 78 74 65 |data acc|ess exte|
|000037a0| 6e 73 69 6f 6e 0d 57 68 | 65 6e 20 61 6e 20 61 70 |nsion.Wh|en an ap|
|000037b0| 70 6c 69 63 61 74 69 6f | 6e 20 63 61 6c 6c 73 20 |plicatio|n calls |
|000037c0| 74 68 65 20 44 42 45 6e | 64 20 66 75 6e 63 74 69 |the DBEn|d functi|
|000037d0| 6f 6e 2c 20 63 6c 6f 73 | 69 6e 67 20 74 68 65 20 |on, clos|ing the |
|000037e0| 6c 61 73 74 20 6f 70 65 | 6e 20 73 65 73 73 69 6f |last ope|n sessio|
|000037f0| 6e 20 66 6f 72 20 61 20 | 64 61 74 61 20 61 63 63 |n for a |data acc|
|00003800| 65 73 73 20 65 78 74 65 | 6e 73 69 6f 6e 2c 20 74 |ess exte|nsion, t|
|00003810| 68 65 20 44 61 74 61 20 | 41 63 63 65 73 73 20 4d |he Data |Access M|
|00003820| 61 6e 61 67 65 72 20 66 | 6f 6c 6c 6f 77 73 20 74 |anager f|ollows t|
|00003830| 68 65 20 6b 44 42 45 6e | 64 20 6d 65 73 73 61 67 |he kDBEn|d messag|
|00003840| 65 20 77 69 74 68 20 61 | 20 6b 44 42 43 6c 6f 73 |e with a| kDBClos|
|00003850| 65 20 6d 65 73 73 61 67 | 65 20 62 65 66 6f 72 65 |e messag|e before|
|00003860| 20 72 65 6d 6f 76 69 6e | 67 20 74 68 65 20 64 61 | removin|g the da|
|00003870| 74 61 20 61 63 63 65 73 | 73 20 65 78 74 65 6e 73 |ta acces|s extens|
|00003880| 69 6f 6e 20 66 72 6f 6d | 20 6d 65 6d 6f 72 79 2e |ion from| memory.|
|00003890| 20 54 68 65 20 64 61 74 | 61 20 61 63 63 65 73 73 | The dat|a access|
|000038a0| 20 65 78 74 65 6e 73 69 | 6f 6e 20 73 68 6f 75 6c | extensi|on shoul|
|000038b0| 64 20 66 72 65 65 20 61 | 6e 79 20 6d 65 6d 6f 72 |d free a|ny memor|
|000038c0| 79 20 74 68 61 74 20 69 | 74 20 61 6c 6c 6f 63 61 |y that i|t alloca|
|000038d0| 74 65 64 20 62 65 66 6f | 72 65 20 72 65 74 75 72 |ted befo|re retur|
|000038e0| 6e 69 6e 67 20 63 6f 6e | 74 72 6f 6c 20 74 6f 20 |ning con|trol to |
|000038f0| 74 68 65 20 44 61 74 61 | 20 41 63 63 65 73 73 20 |the Data| Access |
|00003900| 4d 61 6e 61 67 65 72 2e | 0d 52 65 73 75 6c 74 20 |Manager.|.Result |
|00003910| 63 6f 64 65 0d 6e 6f 45 | 72 72 09 30 09 4e 6f 20 |code.noE|rr.0.No |
|00003920| 65 72 72 6f 72 0d 44 42 | 49 64 6c 65 0d 50 61 72 |error.DB|Idle.Par|
|00003930| 61 6d 65 74 65 72 20 62 | 6c 6f 63 6b 0d 09 ae 09 |ameter b|lock....|
|00003940| 30 30 09 6d 65 73 73 61 | 67 65 09 77 6f 72 64 09 |00.messa|ge.word.|
|00003950| 72 6f 75 74 69 6e 65 20 | 73 65 6c 65 63 74 6f 72 |routine |selector|
|00003960| 3b 20 6b 44 42 49 64 6c | 65 0d 09 ab 09 30 32 09 |; kDBIdl|e....02.|
|00003970| 64 64 65 76 53 74 6f 72 | 61 67 65 09 6c 6f 6e 67 |ddevStor|age.long|
|00003980| 20 09 73 74 6f 72 61 67 | 65 20 66 6f 72 20 64 61 | .storag|e for da|
|00003990| 74 61 20 61 63 63 65 73 | 73 20 09 09 09 09 09 09 |ta acces|s ......|
|000039a0| 65 78 74 65 6e 73 69 6f | 6e 0d 54 68 65 20 44 61 |extensio|n.The Da|
|000039b0| 74 61 20 41 63 63 65 73 | 73 20 4d 61 6e 61 67 65 |ta Acces|s Manage|
|000039c0| 72 20 70 65 72 69 6f 64 | 69 63 61 6c 6c 79 20 73 |r period|ically s|
|000039d0| 65 6e 64 73 20 74 68 65 | 20 6b 44 42 49 64 6c 65 |ends the| kDBIdle|
|000039e0| 20 6d 65 73 73 61 67 65 | 20 74 6f 20 65 61 63 68 | message| to each|
|000039f0| 20 64 61 74 61 20 61 63 | 63 65 73 73 20 65 78 74 | data ac|cess ext|
|00003a00| 65 6e 73 69 6f 6e 2e 20 | 54 68 65 20 64 61 74 61 |ension. |The data|
|00003a10| 20 61 63 63 65 73 73 20 | 65 78 74 65 6e 73 69 6f | access |extensio|
|00003a20| 6e 20 63 61 6e 20 69 67 | 6e 6f 72 65 20 74 68 69 |n can ig|nore thi|
|00003a30| 73 20 6d 65 73 73 61 67 | 65 20 6f 72 20 74 61 6b |s messag|e or tak|
|00003a40| 65 20 74 68 65 20 6f 70 | 70 6f 72 74 75 6e 69 74 |e the op|portunit|
|00003a50| 79 20 74 6f 20 70 65 72 | 66 6f 72 6d 20 70 65 72 |y to per|form per|
|00003a60| 69 6f 64 69 63 20 74 61 | 73 6b 73 2e 20 42 65 63 |iodic ta|sks. Bec|
|00003a70| 61 75 73 65 20 74 68 65 | 20 74 69 6d 69 6e 67 20 |ause the| timing |
|00003a80| 6f 66 20 74 68 65 20 6b | 44 42 49 64 6c 65 20 6d |of the k|DBIdle m|
|00003a90| 65 73 73 61 67 65 73 20 | 6d 69 67 68 74 20 6e 6f |essages |might no|
|00003aa0| 74 20 62 65 20 72 65 67 | 75 6c 61 72 2c 20 74 68 |t be reg|ular, th|
|00003ab0| 65 20 64 61 74 61 20 61 | 63 63 65 73 73 20 65 78 |e data a|ccess ex|
|00003ac0| 74 65 6e 73 69 6f 6e 20 | 6d 75 73 74 20 6e 6f 74 |tension |must not|
|00003ad0| 20 64 65 70 65 6e 64 20 | 6f 6e 20 72 65 63 65 69 | depend |on recei|
|00003ae0| 76 69 6e 67 20 74 68 65 | 73 65 20 6d 65 73 73 61 |ving the|se messa|
|00003af0| 67 65 73 20 61 74 20 70 | 61 72 74 69 63 75 6c 61 |ges at p|articula|
|00003b00| 72 20 74 69 6d 65 73 20 | 6f 72 20 77 69 74 68 20 |r times |or with |
|00003b10| 61 20 70 61 72 74 69 63 | 75 6c 61 72 20 66 72 65 |a partic|ular fre|
|00003b20| 71 75 65 6e 63 79 2e 20 | 0d 52 65 73 75 6c 74 20 |quency. |.Result |
|00003b30| 63 6f 64 65 0d 6e 6f 45 | 72 72 09 30 09 4e 6f 20 |code.noE|rr.0.No |
|00003b40| 65 72 72 6f 72 0d 44 42 | 49 6e 69 74 0d 50 61 72 |error.DB|Init.Par|
|00003b50| 61 6d 65 74 65 72 20 62 | 6c 6f 63 6b 0d 09 ae 09 |ameter b|lock....|
|00003b60| 30 30 09 6d 65 73 73 61 | 67 65 09 77 6f 72 64 09 |00.messa|ge.word.|
|00003b70| 72 6f 75 74 69 6e 65 20 | 73 65 6c 65 63 74 6f 72 |routine |selector|
|00003b80| 3b 20 6b 44 42 49 6e 69 | 74 0d 09 ab 09 30 32 09 |; kDBIni|t....02.|
|00003b90| 64 64 65 76 53 74 6f 72 | 61 67 65 09 6c 6f 6e 67 |ddevStor|age.long|
|00003ba0| 20 09 73 74 6f 72 61 67 | 65 20 66 6f 72 20 64 61 | .storag|e for da|
|00003bb0| 74 61 20 61 63 63 65 73 | 73 20 09 09 09 09 09 09 |ta acces|s ......|
|00003bc0| 65 78 74 65 6e 73 69 6f | 6e 0d 09 ae 09 30 36 09 |extensio|n....06.|
|00003bd0| 61 73 79 6e 63 50 42 09 | 6c 6f 6e 67 09 70 6f 69 |asyncPB.|long.poi|
|00003be0| 6e 74 65 72 20 74 6f 20 | 61 73 79 6e 63 68 20 70 |nter to |asynch p|
|00003bf0| 61 72 61 6d 65 74 65 72 | 20 09 09 09 09 09 62 6c |arameter| .....bl|
|00003c00| 6f 63 6b 0d 09 ac 09 31 | 30 09 73 65 73 73 49 44 |ock....1|0.sessID|
|00003c10| 09 6c 6f 6e 67 09 73 65 | 73 73 69 6f 6e 20 49 44 |.long.se|ssion ID|
|00003c20| 0d 09 ae 09 32 36 09 68 | 6f 73 74 09 6c 6f 6e 67 |....26.h|ost.long|
|00003c30| 09 70 6f 69 6e 74 65 72 | 20 74 6f 20 6e 61 6d 65 |.pointer| to name|
|00003c40| 20 6f 66 20 72 65 6d 6f | 74 65 20 09 09 09 09 09 | of remo|te .....|
|00003c50| 73 79 73 74 65 6d 0d 09 | ae 09 33 30 09 75 73 65 |system..|..30.use|
|00003c60| 72 09 6c 6f 6e 67 09 70 | 6f 69 6e 74 65 72 20 74 |r.long.p|ointer t|
|00003c70| 6f 20 75 73 65 72 20 6e | 61 6d 65 0d 09 ae 09 33 |o user n|ame....3|
|00003c80| 34 09 70 61 73 73 77 6f | 72 64 09 6c 6f 6e 67 09 |4.passwo|rd.long.|
|00003c90| 70 6f 69 6e 74 65 72 20 | 74 6f 20 75 73 65 72 20 |pointer |to user |
|00003ca0| 70 61 73 73 77 6f 72 64 | 0d 09 ae 09 33 38 09 63 |password|....38.c|
|00003cb0| 6f 6e 6e 53 74 72 09 6c | 6f 6e 67 09 70 6f 69 6e |onnStr.l|ong.poin|
|00003cc0| 74 65 72 20 74 6f 20 63 | 6f 6e 6e 65 63 74 69 6f |ter to c|onnectio|
|00003cd0| 6e 20 73 74 72 69 6e 67 | 0d 54 68 65 20 44 42 49 |n string|.The DBI|
|00003ce0| 6e 69 74 20 66 75 6e 63 | 74 69 6f 6e 20 69 6e 69 |nit func|tion ini|
|00003cf0| 74 69 61 74 65 73 20 61 | 20 73 65 73 73 69 6f 6e |tiates a| session|
|00003d00| 20 77 69 74 68 20 61 20 | 72 65 6d 6f 74 65 20 64 | with a |remote d|
|00003d10| 61 74 61 20 73 6f 75 72 | 63 65 2e 20 53 65 65 20 |ata sour|ce. See |
|00003d20| d2 43 6f 6e 74 72 6f 6c | 6c 69 6e 67 20 74 68 65 |.Control|ling the|
|00003d30| 20 53 65 73 73 69 6f 6e | d3 20 69 6e 20 74 68 65 | Session|. in the|
|00003d40| 20 44 61 74 61 20 41 63 | 63 65 73 73 20 4d 61 6e | Data Ac|cess Man|
|00003d50| 61 67 65 72 20 63 68 61 | 70 74 65 72 20 6f 66 20 |ager cha|pter of |
|00003d60| 49 6e 73 69 64 65 20 4d | 61 63 69 6e 74 6f 73 68 |Inside M|acintosh|
|00003d70| 20 56 6f 6c 75 6d 65 20 | 56 49 20 66 6f 72 20 61 | Volume |VI for a|
|00003d80| 20 63 6f 6d 70 6c 65 74 | 65 20 64 65 73 63 72 69 | complet|e descri|
|00003d90| 70 74 69 6f 6e 20 6f 66 | 20 74 68 69 73 20 66 75 |ption of| this fu|
|00003da0| 6e 63 74 69 6f 6e 2e 0d | 52 65 73 75 6c 74 20 63 |nction..|Result c|
|00003db0| 6f 64 65 73 0d 6e 6f 45 | 72 72 20 20 20 20 20 20 |odes.noE|rr |
|00003dc0| 20 20 20 20 30 09 4e 6f | 20 65 72 72 6f 72 0d 72 | 0.No| error.r|
|00003dd0| 63 44 42 45 72 72 6f 72 | 20 20 20 d0 38 30 32 09 |cDBError| .802.|
|00003de0| 45 72 72 6f 72 20 69 6e | 69 74 69 61 74 69 6e 67 |Error in|itiating|
|00003df0| 20 73 65 73 73 69 6f 6e | 0d 44 42 45 6e 64 0d 50 | session|.DBEnd.P|
|00003e00| 61 72 61 6d 65 74 65 72 | 20 62 6c 6f 63 6b 0d 09 |arameter| block..|
|00003e10| ae 09 30 30 09 6d 65 73 | 73 61 67 65 09 77 6f 72 |..00.mes|sage.wor|
|00003e20| 64 09 72 6f 75 74 69 6e | 65 20 73 65 6c 65 63 74 |d.routin|e select|
|00003e30| 6f 72 3b 20 6b 44 42 45 | 6e 64 0d 09 ab 09 30 32 |or; kDBE|nd....02|
|00003e40| 09 64 64 65 76 53 74 6f | 72 61 67 65 09 6c 6f 6e |.ddevSto|rage.lon|
|00003e50| 67 09 73 74 6f 72 61 67 | 65 20 66 6f 72 20 64 61 |g.storag|e for da|
|00003e60| 74 61 20 61 63 63 65 73 | 73 20 09 09 09 09 09 09 |ta acces|s ......|
|00003e70| 65 78 74 65 6e 73 69 6f | 6e 0d 09 ae 09 30 36 09 |extensio|n....06.|
|00003e80| 61 73 79 6e 63 50 42 09 | 6c 6f 6e 67 09 70 6f 69 |asyncPB.|long.poi|
|00003e90| 6e 74 65 72 20 74 6f 20 | 61 73 79 6e 63 68 20 70 |nter to |asynch p|
|00003ea0| 61 72 61 6d 65 74 65 72 | 20 09 09 09 09 09 62 6c |arameter| .....bl|
|00003eb0| 6f 63 6b 0d 09 ae 09 31 | 30 09 73 65 73 73 49 44 |ock....1|0.sessID|
|00003ec0| 09 6c 6f 6e 67 09 73 65 | 73 73 69 6f 6e 20 49 44 |.long.se|ssion ID|
|00003ed0| 0d 54 68 65 20 44 42 45 | 6e 64 20 66 75 6e 63 74 |.The DBE|nd funct|
|00003ee0| 69 6f 6e 20 74 65 72 6d | 69 6e 61 74 65 73 20 61 |ion term|inates a|
|00003ef0| 20 73 65 73 73 69 6f 6e | 20 77 69 74 68 20 61 20 | session| with a |
|00003f00| 72 65 6d 6f 74 65 20 64 | 61 74 61 20 73 6f 75 72 |remote d|ata sour|
|00003f10| 63 65 20 61 6e 64 20 74 | 65 72 6d 69 6e 61 74 65 |ce and t|erminate|
|00003f20| 73 20 74 68 65 20 6e 65 | 74 77 6f 72 6b 20 63 6f |s the ne|twork co|
|00003f30| 6e 6e 65 63 74 69 6f 6e | 20 62 65 74 77 65 65 6e |nnection| between|
|00003f40| 20 74 68 65 20 61 70 70 | 6c 69 63 61 74 69 6f 6e | the app|lication|
|00003f50| 20 61 6e 64 20 74 68 65 | 20 72 65 6d 6f 74 65 20 | and the| remote |
|00003f60| 63 6f 6d 70 75 74 65 72 | 2e 20 53 65 65 20 d2 43 |computer|. See .C|
|00003f70| 6f 6e 74 72 6f 6c 6c 69 | 6e 67 20 74 68 65 20 53 |ontrolli|ng the S|
|00003f80| 65 73 73 69 6f 6e d3 20 | 69 6e 20 74 68 65 20 44 |ession. |in the D|
|00003f90| 61 74 61 20 41 63 63 65 | 73 73 20 4d 61 6e 61 67 |ata Acce|ss Manag|
|00003fa0| 65 72 20 63 68 61 70 74 | 65 72 20 6f 66 20 49 6e |er chapt|er of In|
|00003fb0| 73 69 64 65 20 4d 61 63 | 69 6e 74 6f 73 68 20 56 |side Mac|intosh V|
|00003fc0| 6f 6c 75 6d 65 20 56 49 | 20 66 6f 72 20 61 20 63 |olume VI| for a c|
|00003fd0| 6f 6d 70 6c 65 74 65 20 | 64 65 73 63 72 69 70 74 |omplete |descript|
|00003fe0| 69 6f 6e 20 6f 66 20 74 | 68 69 73 20 66 75 6e 63 |ion of t|his func|
|00003ff0| 74 69 6f 6e 2e 0d 52 65 | 73 75 6c 74 20 63 6f 64 |tion..Re|sult cod|
|00004000| 65 73 0d 6e 6f 45 72 72 | 20 20 20 20 20 20 20 20 |es.noErr| |
|00004010| 30 09 4e 6f 20 65 72 72 | 6f 72 0d 72 63 44 42 45 |0.No err|or.rcDBE|
|00004020| 72 72 6f 72 09 20 20 20 | 20 d0 38 30 32 09 45 72 |rror. | .802.Er|
|00004030| 72 6f 72 20 65 6e 64 69 | 6e 67 20 73 65 73 73 69 |ror endi|ng sessi|
|00004040| 6f 6e 0d 44 42 47 65 74 | 43 6f 6e 6e 49 6e 66 6f |on.DBGet|ConnInfo|
|00004050| 0d 50 61 72 61 6d 65 74 | 65 72 20 62 6c 6f 63 6b |.Paramet|er block|
|00004060| 0d 09 ae 09 30 30 09 6d | 65 73 73 61 67 65 09 77 |....00.m|essage.w|
|00004070| 6f 72 64 09 72 6f 75 74 | 69 6e 65 20 73 65 6c 65 |ord.rout|ine sele|
|00004080| 63 74 6f 72 3b 20 09 09 | 09 09 09 09 09 6b 44 42 |ctor; ..|.....kDB|
|00004090| 47 65 74 43 6f 6e 6e 49 | 6e 66 6f 0d 09 ab 09 30 |GetConnI|nfo....0|
|000040a0| 32 09 64 64 65 76 53 74 | 6f 72 61 67 65 09 6c 6f |2.ddevSt|orage.lo|
|000040b0| 6e 67 09 70 6f 69 6e 74 | 65 72 20 74 6f 20 73 74 |ng.point|er to st|
|000040c0| 6f 72 61 67 65 20 66 6f | 72 20 64 64 65 76 0d 09 |orage fo|r ddev..|
|000040d0| ae 09 30 36 09 61 73 79 | 6e 63 50 42 09 6c 6f 6e |..06.asy|ncPB.lon|
|000040e0| 67 09 70 6f 69 6e 74 65 | 72 20 74 6f 20 61 73 79 |g.pointe|r to asy|
|000040f0| 6e 63 68 20 70 61 72 61 | 6d 65 74 65 72 20 09 09 |nch para|meter ..|
|00004100| 09 09 09 62 6c 6f 63 6b | 0d 09 ae 09 31 30 09 73 |...block|....10.s|
|00004110| 65 73 73 49 44 09 6c 6f | 6e 67 09 73 65 73 73 69 |essID.lo|ng.sessi|
|00004120| 6f 6e 20 49 44 0d 09 ac | 09 31 34 09 72 65 74 75 |on ID...|.14.retu|
|00004130| 72 6e 65 64 20 49 44 09 | 6c 6f 6e 67 09 73 65 73 |rned ID.|long.ses|
|00004140| 73 69 6f 6e 20 49 44 20 | 72 65 74 75 72 6e 65 64 |sion ID |returned|
|00004150| 0d 09 ac 09 31 38 09 76 | 65 72 73 69 6f 6e 09 6c |....18.v|ersion.l|
|00004160| 6f 6e 67 09 76 65 72 73 | 69 6f 6e 20 6e 75 6d 62 |ong.vers|ion numb|
|00004170| 65 72 0d 09 ac 09 32 32 | 09 73 74 61 72 74 09 6c |er....22|.start.l|
|00004180| 6f 6e 67 09 73 65 73 73 | 69 6f 6e 20 73 74 61 72 |ong.sess|ion star|
|00004190| 74 20 74 69 6d 65 20 69 | 6e 20 74 69 63 6b 73 0d |t time i|n ticks.|
|000041a0| 09 ac 09 32 36 09 68 6f | 73 74 09 6c 6f 6e 67 09 |...26.ho|st.long.|
|000041b0| 70 6f 69 6e 74 65 72 20 | 74 6f 20 6e 61 6d 65 20 |pointer |to name |
|000041c0| 6f 66 20 72 65 6d 6f 74 | 65 20 09 09 09 09 09 73 |of remot|e .....s|
|000041d0| 79 73 74 65 6d 0d 09 ac | 09 33 30 09 75 73 65 72 |ystem...|.30.user|
|000041e0| 09 6c 6f 6e 67 09 70 6f | 69 6e 74 65 72 20 74 6f |.long.po|inter to|
|000041f0| 20 75 73 65 72 20 6e 61 | 6d 65 0d 09 ac 09 33 38 | user na|me....38|
|00004200| 09 63 6f 6e 6e 53 74 72 | 09 6c 6f 6e 67 09 70 6f |.connStr|.long.po|
|00004210| 69 6e 74 65 72 20 74 6f | 20 63 6f 6e 6e 65 63 74 |inter to| connect|
|00004220| 69 6f 6e 20 73 74 72 69 | 6e 67 0d 09 ac 09 34 32 |ion stri|ng....42|
|00004230| 09 6e 65 74 77 6f 72 6b | 09 6c 6f 6e 67 09 70 6f |.network|.long.po|
|00004240| 69 6e 74 65 72 20 74 6f | 20 6e 61 6d 65 20 6f 66 |inter to| name of|
|00004250| 20 6e 65 74 77 6f 72 6b | 0d 09 ae 09 37 38 09 73 | network|....78.s|
|00004260| 65 73 73 4e 75 6d 09 77 | 6f 72 64 09 73 65 73 73 |essNum.w|ord.sess|
|00004270| 69 6f 6e 20 6e 75 6d 62 | 65 72 0d 09 ac 09 38 30 |ion numb|er....80|
|00004280| 09 73 74 61 74 65 09 77 | 6f 72 64 09 73 74 61 74 |.state.w|ord.stat|
|00004290| 75 73 20 6f 66 20 64 61 | 74 61 20 73 6f 75 72 63 |us of da|ta sourc|
|000042a0| 65 0d 54 68 65 20 44 42 | 47 65 74 43 6f 6e 6e 49 |e.The DB|GetConnI|
|000042b0| 6e 66 6f 20 66 75 6e 63 | 74 69 6f 6e 20 72 65 74 |nfo func|tion ret|
|000042c0| 75 72 6e 73 20 69 6e 66 | 6f 72 6d 61 74 69 6f 6e |urns inf|ormation|
|000042d0| 20 61 62 6f 75 74 20 74 | 68 65 20 73 70 65 63 69 | about t|he speci|
|000042e0| 66 69 65 64 20 73 65 73 | 73 69 6f 6e 2e 20 53 65 |fied ses|sion. Se|
|000042f0| 65 20 d2 43 6f 6e 74 72 | 6f 6c 6c 69 6e 67 20 74 |e .Contr|olling t|
|00004300| 68 65 20 53 65 73 73 69 | 6f 6e d3 20 69 6e 20 74 |he Sessi|on. in t|
|00004310| 68 65 20 44 61 74 61 20 | 41 63 63 65 73 73 20 4d |he Data |Access M|
|00004320| 61 6e 61 67 65 72 20 63 | 68 61 70 74 65 72 20 6f |anager c|hapter o|
|00004330| 66 20 49 6e 73 69 64 65 | 20 4d 61 63 69 6e 74 6f |f Inside| Macinto|
|00004340| 73 68 20 56 6f 6c 75 6d | 65 20 56 49 20 66 6f 72 |sh Volum|e VI for|
|00004350| 20 61 20 63 6f 6d 70 6c | 65 74 65 20 64 65 73 63 | a compl|ete desc|
|00004360| 72 69 70 74 69 6f 6e 20 | 6f 66 20 74 68 69 73 20 |ription |of this |
|00004370| 66 75 6e 63 74 69 6f 6e | 2e 0d 52 65 73 75 6c 74 |function|..Result|
|00004380| 20 63 6f 64 65 73 0d 6e | 6f 45 72 72 20 20 20 20 | codes.n|oErr |
|00004390| 20 20 20 20 20 20 20 20 | 20 20 20 20 30 09 09 4e | | 0..N|
|000043a0| 6f 20 65 72 72 6f 72 0d | 72 63 44 42 42 61 64 53 |o error.|rcDBBadS|
|000043b0| 65 73 73 4e 75 6d 20 20 | 20 09 d0 38 30 38 09 49 |essNum | ..808.I|
|000043c0| 6e 76 61 6c 69 64 20 73 | 65 73 73 69 6f 6e 20 6e |nvalid s|ession n|
|000043d0| 75 6d 62 65 72 0d 44 42 | 47 65 74 53 65 73 73 69 |umber.DB|GetSessi|
|000043e0| 6f 6e 4e 75 6d 0d 50 61 | 72 61 6d 65 74 65 72 20 |onNum.Pa|rameter |
|000043f0| 62 6c 6f 63 6b 0d 09 ae | 09 30 30 09 6d 65 73 73 |block...|.00.mess|
|00004400| 61 67 65 09 77 6f 72 64 | 09 72 6f 75 74 69 6e 65 |age.word|.routine|
|00004410| 20 73 65 6c 65 63 74 6f | 72 3b 20 0d 09 09 09 09 | selecto|r; .....|
|00004420| 09 6b 44 42 47 65 74 53 | 65 73 73 69 6f 6e 4e 75 |.kDBGetS|essionNu|
|00004430| 6d 0d 09 ab 09 30 32 09 | 64 64 65 76 53 74 6f 72 |m....02.|ddevStor|
|00004440| 61 67 65 09 6c 6f 6e 67 | 20 09 73 74 6f 72 61 67 |age.long| .storag|
|00004450| 65 20 66 6f 72 20 64 61 | 74 61 20 61 63 63 65 73 |e for da|ta acces|
|00004460| 73 20 09 09 09 09 09 09 | 65 78 74 65 6e 73 69 6f |s ......|extensio|
|00004470| 6e 0d 09 ae 09 30 36 09 | 61 73 79 6e 63 50 42 09 |n....06.|asyncPB.|
|00004480| 6c 6f 6e 67 09 70 6f 69 | 6e 74 65 72 20 74 6f 20 |long.poi|nter to |
|00004490| 61 73 79 6e 63 68 20 70 | 61 72 61 6d 65 74 65 72 |asynch p|arameter|
|000044a0| 20 09 09 09 09 09 62 6c | 6f 63 6b 0d 09 ae 09 31 | .....bl|ock....1|
|000044b0| 30 09 73 65 73 73 49 44 | 09 6c 6f 6e 67 09 73 65 |0.sessID|.long.se|
|000044c0| 73 73 69 6f 6e 20 49 44 | 0d 09 ac 09 37 38 09 73 |ssion ID|....78.s|
|000044d0| 65 73 73 4e 75 6d 09 77 | 6f 72 64 09 73 65 73 73 |essNum.w|ord.sess|
|000044e0| 69 6f 6e 20 6e 75 6d 62 | 65 72 0d 54 68 65 20 44 |ion numb|er.The D|
|000044f0| 42 47 65 74 53 65 73 73 | 69 6f 6e 4e 75 6d 20 66 |BGetSess|ionNum f|
|00004500| 75 6e 63 74 69 6f 6e 20 | 72 65 74 75 72 6e 73 20 |unction |returns |
|00004510| 61 20 73 65 73 73 69 6f | 6e 20 6e 75 6d 62 65 72 |a sessio|n number|
|00004520| 2e 20 53 65 65 20 d2 43 | 6f 6e 74 72 6f 6c 6c 69 |. See .C|ontrolli|
|00004530| 6e 67 20 74 68 65 20 53 | 65 73 73 69 6f 6e d3 20 |ng the S|ession. |
|00004540| 69 6e 20 74 68 65 20 44 | 61 74 61 20 41 63 63 65 |in the D|ata Acce|
|00004550| 73 73 20 4d 61 6e 61 67 | 65 72 20 63 68 61 70 74 |ss Manag|er chapt|
|00004560| 65 72 20 6f 66 20 49 6e | 73 69 64 65 20 4d 61 63 |er of In|side Mac|
|00004570| 69 6e 74 6f 73 68 20 56 | 6f 6c 75 6d 65 20 56 49 |intosh V|olume VI|
|00004580| 20 66 6f 72 20 61 20 63 | 6f 6d 70 6c 65 74 65 20 | for a c|omplete |
|00004590| 64 65 73 63 72 69 70 74 | 69 6f 6e 20 6f 66 20 74 |descript|ion of t|
|000045a0| 68 69 73 20 66 75 6e 63 | 74 69 6f 6e 2e 0d 52 65 |his func|tion..Re|
|000045b0| 73 75 6c 74 20 63 6f 64 | 65 73 0d 6e 6f 45 72 72 |sult cod|es.noErr|
|000045c0| 20 20 20 20 20 20 20 20 | 20 20 20 20 30 09 4e 6f | | 0.No|
|000045d0| 20 65 72 72 6f 72 0d 72 | 63 44 42 45 72 72 6f 72 | error.r|cDBError|
|000045e0| 20 20 20 09 d0 20 38 30 | 32 09 45 72 72 6f 72 20 | .. 80|2.Error |
|000045f0| 67 65 74 74 69 6e 67 20 | 73 65 73 73 69 6f 6e 20 |getting |session |
|00004600| 6e 75 6d 62 65 72 0d 44 | 42 4b 69 6c 6c 0d 50 61 |number.D|BKill.Pa|
|00004610| 72 61 6d 65 74 65 72 73 | 20 75 73 65 64 0d 09 ae |rameters| used...|
|00004620| 09 30 30 09 6d 65 73 73 | 61 67 65 09 77 6f 72 64 |.00.mess|age.word|
|00004630| 09 72 6f 75 74 69 6e 65 | 20 73 65 6c 65 63 74 6f |.routine| selecto|
|00004640| 72 3b 20 6b 44 42 4b 69 | 6c 6c 0d 09 ab 09 30 32 |r; kDBKi|ll....02|
|00004650| 09 64 64 65 76 53 74 6f | 72 61 67 65 09 6c 6f 6e |.ddevSto|rage.lon|
|00004660| 67 20 09 73 74 6f 72 61 | 67 65 20 66 6f 72 20 64 |g .stora|ge for d|
|00004670| 61 74 61 20 61 63 63 65 | 73 73 20 09 09 09 09 09 |ata acce|ss .....|
|00004680| 09 65 78 74 65 6e 73 69 | 6f 6e 0d 09 ae 09 30 36 |.extensi|on....06|
|00004690| 09 61 73 79 6e 63 50 42 | 09 6c 6f 6e 67 09 70 6f |.asyncPB|.long.po|
|000046a0| 69 6e 74 65 72 20 74 6f | 20 61 73 79 6e 63 68 20 |inter to| asynch |
|000046b0| 70 61 72 61 6d 65 74 65 | 72 20 09 09 09 09 09 62 |paramete|r .....b|
|000046c0| 6c 6f 63 6b 0d 54 68 65 | 20 44 42 4b 69 6c 6c 20 |lock.The| DBKill |
|000046d0| 66 75 6e 63 74 69 6f 6e | 20 63 61 6e 63 65 6c 73 |function| cancels|
|000046e0| 20 74 68 65 20 65 78 65 | 63 75 74 69 6f 6e 20 6f | the exe|cution o|
|000046f0| 66 20 61 6e 20 61 73 79 | 6e 63 68 72 6f 6e 6f 75 |f an asy|nchronou|
|00004700| 73 20 63 61 6c 6c 2e 20 | 53 65 65 20 d2 43 6f 6e |s call. |See .Con|
|00004710| 74 72 6f 6c 6c 69 6e 67 | 20 74 68 65 20 53 65 73 |trolling| the Ses|
|00004720| 73 69 6f 6e d3 20 69 6e | 20 74 68 65 20 44 61 74 |sion. in| the Dat|
|00004730| 61 20 41 63 63 65 73 73 | 20 4d 61 6e 61 67 65 72 |a Access| Manager|
|00004740| 20 63 68 61 70 74 65 72 | 20 6f 66 20 49 6e 73 69 | chapter| of Insi|
|00004750| 64 65 20 4d 61 63 69 6e | 74 6f 73 68 20 56 6f 6c |de Macin|tosh Vol|
|00004760| 75 6d 65 20 56 49 20 66 | 6f 72 20 61 20 63 6f 6d |ume VI f|or a com|
|00004770| 70 6c 65 74 65 20 64 65 | 73 63 72 69 70 74 69 6f |plete de|scriptio|
|00004780| 6e 20 6f 66 20 74 68 69 | 73 20 66 75 6e 63 74 69 |n of thi|s functi|
|00004790| 6f 6e 2e 0d 52 65 73 75 | 6c 74 20 63 6f 64 65 73 |on..Resu|lt codes|
|000047a0| 0d 6e 6f 45 72 72 20 20 | 20 20 20 20 20 20 30 09 |.noErr | 0.|
|000047b0| 41 73 79 6e 63 68 72 6f | 6e 6f 75 73 20 72 6f 75 |Asynchro|nous rou|
|000047c0| 74 69 6e 65 20 63 61 6e | 63 65 6c 65 64 20 73 75 |tine can|celed su|
|000047d0| 63 63 65 73 73 66 75 6c | 6c 79 0d 72 63 44 42 45 |ccessful|ly.rcDBE|
|000047e0| 72 72 6f 72 20 20 09 d0 | 38 30 32 09 45 72 72 6f |rror ..|802.Erro|
|000047f0| 72 20 63 61 6e 63 65 6c | 69 6e 67 20 72 6f 75 74 |r cancel|ing rout|
|00004800| 69 6e 65 0d 44 42 53 65 | 6e 64 0d 50 61 72 61 6d |ine.DBSe|nd.Param|
|00004810| 65 74 65 72 20 62 6c 6f | 63 6b 0d 09 ae 09 30 30 |eter blo|ck....00|
|00004820| 09 6d 65 73 73 61 67 65 | 09 77 6f 72 64 09 72 6f |.message|.word.ro|
|00004830| 75 74 69 6e 65 20 73 65 | 6c 65 63 74 6f 72 3b 20 |utine se|lector; |
|00004840| 6b 44 42 53 65 6e 64 0d | 09 ab 09 30 32 09 64 64 |kDBSend.|...02.dd|
|00004850| 65 76 53 74 6f 72 61 67 | 65 09 6c 6f 6e 67 20 09 |evStorag|e.long .|
|00004860| 73 74 6f 72 61 67 65 20 | 66 6f 72 20 64 61 74 61 |storage |for data|
|00004870| 20 61 63 63 65 73 73 20 | 09 09 09 09 09 09 65 78 | access |......ex|
|00004880| 74 65 6e 73 69 6f 6e 0d | 09 ae 09 30 36 09 61 73 |tension.|...06.as|
|00004890| 79 6e 63 50 42 09 6c 6f | 6e 67 09 70 6f 69 6e 74 |yncPB.lo|ng.point|
|000048a0| 65 72 20 74 6f 20 61 73 | 79 6e 63 68 20 70 61 72 |er to as|ynch par|
|000048b0| 61 6d 65 74 65 72 20 09 | 09 09 09 09 62 6c 6f 63 |ameter .|....bloc|
|000048c0| 6b 0d 09 ae 09 31 30 09 | 73 65 73 73 49 44 09 6c |k....10.|sessID.l|
|000048d0| 6f 6e 67 09 73 65 73 73 | 69 6f 6e 20 49 44 0d 09 |ong.sess|ion ID..|
|000048e0| ae 09 34 36 09 62 75 66 | 66 65 72 09 6c 6f 6e 67 |..46.buf|fer.long|
|000048f0| 09 70 6f 69 6e 74 65 72 | 20 74 6f 20 64 61 74 61 |.pointer| to data|
|00004900| 20 62 75 66 66 65 72 0d | 09 ae 09 38 32 09 6c 65 | buffer.|...82.le|
|00004910| 6e 09 77 6f 72 64 09 6c | 65 6e 67 74 68 20 6f 66 |n.word.l|ength of|
|00004920| 20 64 61 74 61 0d 54 68 | 65 20 44 42 53 65 6e 64 | data.Th|e DBSend|
|00004930| 20 66 75 6e 63 74 69 6f | 6e 20 73 65 6e 64 73 20 | functio|n sends |
|00004940| 61 20 71 75 65 72 79 20 | 6f 72 20 61 20 70 6f 72 |a query |or a por|
|00004950| 74 69 6f 6e 20 6f 66 20 | 61 20 71 75 65 72 79 20 |tion of |a query |
|00004960| 74 6f 20 74 68 65 20 72 | 65 6d 6f 74 65 20 64 61 |to the r|emote da|
|00004970| 74 61 20 73 6f 75 72 63 | 65 2e 20 53 65 65 20 d2 |ta sourc|e. See .|
|00004980| 53 65 6e 64 69 6e 67 20 | 61 6e 64 20 45 78 65 63 |Sending |and Exec|
|00004990| 75 74 69 6e 67 20 51 75 | 65 72 69 65 73 d3 20 69 |uting Qu|eries. i|
|000049a0| 6e 20 74 68 65 20 44 61 | 74 61 20 41 63 63 65 73 |n the Da|ta Acces|
|000049b0| 73 20 4d 61 6e 61 67 65 | 72 20 63 68 61 70 74 65 |s Manage|r chapte|
|000049c0| 72 20 6f 66 20 49 6e 73 | 69 64 65 20 4d 61 63 69 |r of Ins|ide Maci|
|000049d0| 6e 74 6f 73 68 20 56 6f | 6c 75 6d 65 20 56 49 20 |ntosh Vo|lume VI |
|000049e0| 66 6f 72 20 61 20 63 6f | 6d 70 6c 65 74 65 20 64 |for a co|mplete d|
|000049f0| 65 73 63 72 69 70 74 69 | 6f 6e 20 6f 66 20 74 68 |escripti|on of th|
|00004a00| 69 73 20 66 75 6e 63 74 | 69 6f 6e 2e 0d 52 65 73 |is funct|ion..Res|
|00004a10| 75 6c 74 20 63 6f 64 65 | 73 0d 6e 6f 45 72 72 20 |ult code|s.noErr |
|00004a20| 20 20 20 20 20 20 20 30 | 09 4e 6f 20 65 72 72 6f | 0|.No erro|
|00004a30| 72 0d 72 63 44 42 45 72 | 72 6f 72 09 20 20 20 d0 |r.rcDBEr|ror. .|
|00004a40| 38 30 32 09 45 72 72 6f | 72 20 74 72 79 69 6e 67 |802.Erro|r trying|
|00004a50| 20 74 6f 20 73 65 6e 64 | 20 74 65 78 74 0d 44 42 | to send| text.DB|
|00004a60| 53 65 6e 64 49 74 65 6d | 0d 50 61 72 61 6d 65 74 |SendItem|.Paramet|
|00004a70| 65 72 20 62 6c 6f 63 6b | 0d 09 ae 09 30 30 09 6d |er block|....00.m|
|00004a80| 65 73 73 61 67 65 09 77 | 6f 72 64 09 72 6f 75 74 |essage.w|ord.rout|
|00004a90| 69 6e 65 20 73 65 6c 65 | 63 74 6f 72 3b 20 09 09 |ine sele|ctor; ..|
|00004aa0| 09 09 09 09 09 6b 44 42 | 53 65 6e 64 49 74 65 6d |.....kDB|SendItem|
|00004ab0| 0d 09 ab 09 30 32 09 64 | 64 65 76 53 74 6f 72 61 |....02.d|devStora|
|00004ac0| 67 65 09 6c 6f 6e 67 20 | 09 73 74 6f 72 61 67 65 |ge.long |.storage|
|00004ad0| 20 66 6f 72 20 64 61 74 | 61 20 61 63 63 65 73 73 | for dat|a access|
|00004ae0| 20 09 09 09 09 09 09 65 | 78 74 65 6e 73 69 6f 6e | ......e|xtension|
|00004af0| 0d 09 ae 09 30 36 09 61 | 73 79 6e 63 50 42 09 6c |....06.a|syncPB.l|
|00004b00| 6f 6e 67 09 70 6f 69 6e | 74 65 72 20 74 6f 20 61 |ong.poin|ter to a|
|00004b10| 73 79 6e 63 68 20 70 61 | 72 61 6d 65 74 65 72 20 |synch pa|rameter |
|00004b20| 09 09 09 09 09 62 6c 6f | 63 6b 0d 09 ae 09 31 30 |.....blo|ck....10|
|00004b30| 09 73 65 73 73 49 44 09 | 6c 6f 6e 67 09 73 65 73 |.sessID.|long.ses|
|00004b40| 73 69 6f 6e 20 49 44 0d | 09 ae 09 34 36 09 62 75 |sion ID.|...46.bu|
|00004b50| 66 66 65 72 09 6c 6f 6e | 67 09 70 6f 69 6e 74 65 |ffer.lon|g.pointe|
|00004b60| 72 20 74 6f 20 64 61 74 | 61 20 62 75 66 66 65 72 |r to dat|a buffer|
|00004b70| 0d 09 ae 09 37 34 09 64 | 61 74 61 54 79 70 65 09 |....74.d|ataType.|
|00004b80| 6c 6f 6e 67 09 64 61 74 | 61 20 74 79 70 65 0d 09 |long.dat|a type..|
|00004b90| ae 09 38 32 09 6c 65 6e | 09 77 6f 72 64 09 6c 65 |..82.len|.word.le|
|00004ba0| 6e 67 74 68 20 6f 66 20 | 64 61 74 61 20 69 74 65 |ngth of |data ite|
|00004bb0| 6d 0d 09 ae 09 38 34 09 | 70 6c 61 63 65 73 09 77 |m....84.|places.w|
|00004bc0| 6f 72 64 09 64 65 63 69 | 6d 61 6c 20 70 6c 61 63 |ord.deci|mal plac|
|00004bd0| 65 73 20 69 6e 20 64 61 | 74 61 20 69 74 65 6d 0d |es in da|ta item.|
|00004be0| 09 ae 09 38 36 09 66 6c | 61 67 73 09 77 6f 72 64 |...86.fl|ags.word|
|00004bf0| 09 66 6c 61 67 73 0d 54 | 68 65 20 44 42 53 65 6e |.flags.T|he DBSen|
|00004c00| 64 49 74 65 6d 20 66 75 | 6e 63 74 69 6f 6e 20 73 |dItem fu|nction s|
|00004c10| 65 6e 64 73 20 61 20 73 | 69 6e 67 6c 65 20 64 61 |ends a s|ingle da|
|00004c20| 74 61 20 69 74 65 6d 20 | 74 6f 20 74 68 65 20 72 |ta item |to the r|
|00004c30| 65 6d 6f 74 65 20 64 61 | 74 61 20 73 6f 75 72 63 |emote da|ta sourc|
|00004c40| 65 2e 20 53 65 65 20 d2 | 53 65 6e 64 69 6e 67 20 |e. See .|Sending |
|00004c50| 61 6e 64 20 45 78 65 63 | 75 74 69 6e 67 20 51 75 |and Exec|uting Qu|
|00004c60| 65 72 69 65 73 d3 20 69 | 6e 20 74 68 65 20 44 61 |eries. i|n the Da|
|00004c70| 74 61 20 41 63 63 65 73 | 73 20 4d 61 6e 61 67 65 |ta Acces|s Manage|
|00004c80| 72 20 63 68 61 70 74 65 | 72 20 6f 66 20 49 6e 73 |r chapte|r of Ins|
|00004c90| 69 64 65 20 4d 61 63 69 | 6e 74 6f 73 68 20 56 6f |ide Maci|ntosh Vo|
|00004ca0| 6c 75 6d 65 20 56 49 20 | 66 6f 72 20 61 20 63 6f |lume VI |for a co|
|00004cb0| 6d 70 6c 65 74 65 20 64 | 65 73 63 72 69 70 74 69 |mplete d|escripti|
|00004cc0| 6f 6e 20 6f 66 20 74 68 | 69 73 20 66 75 6e 63 74 |on of th|is funct|
|00004cd0| 69 6f 6e 2e 0d 52 65 73 | 75 6c 74 20 63 6f 64 65 |ion..Res|ult code|
|00004ce0| 73 0d 6e 6f 45 72 72 20 | 20 20 20 20 20 20 20 30 |s.noErr | 0|
|00004cf0| 09 4e 6f 20 65 72 72 6f | 72 0d 72 63 44 42 45 72 |.No erro|r.rcDBEr|
|00004d00| 72 6f 72 09 20 20 20 20 | d0 38 30 32 09 45 72 72 |ror. |.802.Err|
|00004d10| 6f 72 20 74 72 79 69 6e | 67 20 74 6f 20 73 65 6e |or tryin|g to sen|
|00004d20| 64 20 69 74 65 6d 0d 44 | 42 45 78 65 63 0d 50 61 |d item.D|BExec.Pa|
|00004d30| 72 61 6d 65 74 65 72 20 | 62 6c 6f 63 6b 0d 09 ae |rameter |block...|
|00004d40| 09 30 30 09 6d 65 73 73 | 61 67 65 09 77 6f 72 64 |.00.mess|age.word|
|00004d50| 09 72 6f 75 74 69 6e 65 | 20 73 65 6c 65 63 74 6f |.routine| selecto|
|00004d60| 72 3b 20 6b 44 42 45 78 | 65 63 0d 09 ab 09 30 32 |r; kDBEx|ec....02|
|00004d70| 09 64 64 65 76 53 74 6f | 72 61 67 65 09 6c 6f 6e |.ddevSto|rage.lon|
|00004d80| 67 20 09 73 74 6f 72 61 | 67 65 20 66 6f 72 20 64 |g .stora|ge for d|
|00004d90| 61 74 61 20 61 63 63 65 | 73 73 20 09 09 09 09 09 |ata acce|ss .....|
|00004da0| 09 65 78 74 65 6e 73 69 | 6f 6e 0d 09 ae 09 30 36 |.extensi|on....06|
|00004db0| 09 61 73 79 6e 63 50 42 | 09 6c 6f 6e 67 09 70 6f |.asyncPB|.long.po|
|00004dc0| 69 6e 74 65 72 20 74 6f | 20 61 73 79 6e 63 68 20 |inter to| asynch |
|00004dd0| 70 61 72 61 6d 65 74 65 | 72 20 09 09 09 09 09 62 |paramete|r .....b|
|00004de0| 6c 6f 63 6b 0d 09 ae 09 | 31 30 09 73 65 73 73 49 |lock....|10.sessI|
|00004df0| 44 09 6c 6f 6e 67 09 73 | 65 73 73 69 6f 6e 20 49 |D.long.s|ession I|
|00004e00| 44 0d 54 68 65 20 44 42 | 45 78 65 63 20 66 75 6e |D.The DB|Exec fun|
|00004e10| 63 74 69 6f 6e 20 69 6e | 69 74 69 61 74 65 73 20 |ction in|itiates |
|00004e20| 65 78 65 63 75 74 69 6f | 6e 20 6f 66 20 61 20 71 |executio|n of a q|
|00004e30| 75 65 72 79 2e 20 53 65 | 65 20 d2 53 65 6e 64 69 |uery. Se|e .Sendi|
|00004e40| 6e 67 20 61 6e 64 20 45 | 78 65 63 75 74 69 6e 67 |ng and E|xecuting|
|00004e50| 20 51 75 65 72 69 65 73 | d3 20 69 6e 20 74 68 65 | Queries|. in the|
|00004e60| 20 44 61 74 61 20 41 63 | 63 65 73 73 20 4d 61 6e | Data Ac|cess Man|
|00004e70| 61 67 65 72 20 63 68 61 | 70 74 65 72 20 6f 66 20 |ager cha|pter of |
|00004e80| 49 6e 73 69 64 65 20 4d | 61 63 69 6e 74 6f 73 68 |Inside M|acintosh|
|00004e90| 20 56 6f 6c 75 6d 65 20 | 56 49 20 66 6f 72 20 61 | Volume |VI for a|
|00004ea0| 20 63 6f 6d 70 6c 65 74 | 65 20 64 65 73 63 72 69 | complet|e descri|
|00004eb0| 70 74 69 6f 6e 20 6f 66 | 20 74 68 69 73 20 66 75 |ption of| this fu|
|00004ec0| 6e 63 74 69 6f 6e 2e 0d | 52 65 73 75 6c 74 20 63 |nction..|Result c|
|00004ed0| 6f 64 65 73 0d 6e 6f 45 | 72 72 20 20 20 20 20 20 |odes.noE|rr |
|00004ee0| 20 20 20 30 09 45 78 65 | 63 75 74 69 6f 6e 20 68 | 0.Exe|cution h|
|00004ef0| 61 73 20 62 65 67 75 6e | 0d 72 63 44 42 45 72 72 |as begun|.rcDBErr|
|00004f00| 6f 72 20 20 20 d0 38 30 | 32 09 45 72 72 6f 72 20 |or .80|2.Error |
|00004f10| 74 72 79 69 6e 67 20 74 | 6f 20 62 65 67 69 6e 20 |trying t|o begin |
|00004f20| 65 78 65 63 75 74 69 6f | 6e 0d 44 42 53 74 61 74 |executio|n.DBStat|
|00004f30| 65 0d 50 61 72 61 6d 65 | 74 65 72 20 62 6c 6f 63 |e.Parame|ter bloc|
|00004f40| 6b 0d 09 ae 09 30 30 09 | 6d 65 73 73 61 67 65 09 |k....00.|message.|
|00004f50| 77 6f 72 64 09 72 6f 75 | 74 69 6e 65 20 73 65 6c |word.rou|tine sel|
|00004f60| 65 63 74 6f 72 3b 20 6b | 44 42 53 74 61 74 65 0d |ector; k|DBState.|
|00004f70| 09 ab 09 30 32 09 64 64 | 65 76 53 74 6f 72 61 67 |...02.dd|evStorag|
|00004f80| 65 09 6c 6f 6e 67 20 09 | 73 74 6f 72 61 67 65 20 |e.long .|storage |
|00004f90| 66 6f 72 20 64 61 74 61 | 20 61 63 63 65 73 73 20 |for data| access |
|00004fa0| 09 09 09 09 09 09 65 78 | 74 65 6e 73 69 6f 6e 0d |......ex|tension.|
|00004fb0| 09 ae 09 30 36 09 61 73 | 79 6e 63 50 42 09 6c 6f |...06.as|yncPB.lo|
|00004fc0| 6e 67 09 70 6f 69 6e 74 | 65 72 20 74 6f 20 61 73 |ng.point|er to as|
|00004fd0| 79 6e 63 68 20 70 61 72 | 61 6d 65 74 65 72 20 09 |ynch par|ameter .|
|00004fe0| 09 09 09 09 62 6c 6f 63 | 6b 0d 09 ae 09 31 30 09 |....bloc|k....10.|
|00004ff0| 73 65 73 73 49 44 09 6c | 6f 6e 67 09 73 65 73 73 |sessID.l|ong.sess|
|00005000| 69 6f 6e 20 49 44 0d 54 | 68 65 20 72 65 73 75 6c |ion ID.T|he resul|
|00005010| 74 20 63 6f 64 65 20 72 | 65 74 75 72 6e 65 64 20 |t code r|eturned |
|00005020| 62 79 20 74 68 65 20 44 | 42 53 74 61 74 65 20 66 |by the D|BState f|
|00005030| 75 6e 63 74 69 6f 6e 20 | 69 6e 64 69 63 61 74 65 |unction |indicate|
|00005040| 73 20 74 68 65 20 73 74 | 61 74 75 73 20 6f 66 20 |s the st|atus of |
|00005050| 74 68 65 20 72 65 6d 6f | 74 65 20 64 61 74 61 20 |the remo|te data |
|00005060| 73 6f 75 72 63 65 2e 20 | 53 65 65 20 d2 53 65 6e |source. |See .Sen|
|00005070| 64 69 6e 67 20 61 6e 64 | 20 45 78 65 63 75 74 69 |ding and| Executi|
|00005080| 6e 67 20 51 75 65 72 69 | 65 73 d3 20 69 6e 20 74 |ng Queri|es. in t|
|00005090| 68 65 20 44 61 74 61 20 | 41 63 63 65 73 73 20 4d |he Data |Access M|
|000050a0| 61 6e 61 67 65 72 20 63 | 68 61 70 74 65 72 20 6f |anager c|hapter o|
|000050b0| 66 20 49 6e 73 69 64 65 | 20 4d 61 63 69 6e 74 6f |f Inside| Macinto|
|000050c0| 73 68 20 56 6f 6c 75 6d | 65 20 56 49 20 66 6f 72 |sh Volum|e VI for|
|000050d0| 20 61 20 63 6f 6d 70 6c | 65 74 65 20 64 65 73 63 | a compl|ete desc|
|000050e0| 72 69 70 74 69 6f 6e 20 | 6f 66 20 74 68 69 73 20 |ription |of this |
|000050f0| 66 75 6e 63 74 69 6f 6e | 2e 0d 52 65 73 75 6c 74 |function|..Result|
|00005100| 20 63 6f 64 65 73 0d 6e | 6f 45 72 72 20 20 20 20 | codes.n|oErr |
|00005110| 20 20 20 20 30 09 4e 6f | 20 65 72 72 6f 72 3b 20 | 0.No| error; |
|00005120| 72 65 61 64 79 20 66 6f | 72 20 6d 6f 72 65 20 74 |ready fo|r more t|
|00005130| 65 78 74 0d 72 63 44 42 | 56 61 6c 75 65 20 20 20 |ext.rcDB|Value |
|00005140| 20 20 d0 38 30 31 09 4f | 75 74 70 75 74 20 64 61 | .801.O|utput da|
|00005150| 74 61 20 61 76 61 69 6c | 61 62 6c 65 0d 72 63 44 |ta avail|able.rcD|
|00005160| 42 45 72 72 6f 72 20 20 | 20 20 d0 20 38 30 32 09 |BError | . 802.|
|00005170| 45 78 65 63 75 74 69 6f | 6e 20 65 6e 64 65 64 20 |Executio|n ended |
|00005180| 69 6e 20 61 6e 20 65 72 | 72 6f 72 0d 72 63 44 42 |in an er|ror.rcDB|
|00005190| 45 78 65 63 09 20 20 20 | 20 20 20 20 d0 38 30 36 |Exec. | .806|
|000051a0| 09 43 75 72 72 65 6e 74 | 6c 79 20 65 78 65 63 75 |.Current|ly execu|
|000051b0| 74 69 6e 67 20 71 75 65 | 72 79 0d 44 42 47 65 74 |ting que|ry.DBGet|
|000051c0| 45 72 72 0d 50 61 72 61 | 6d 65 74 65 72 20 62 6c |Err.Para|meter bl|
|000051d0| 6f 63 6b 0d 09 ae 09 30 | 30 09 6d 65 73 73 61 67 |ock....0|0.messag|
|000051e0| 65 09 77 6f 72 64 09 72 | 6f 75 74 69 6e 65 20 73 |e.word.r|outine s|
|000051f0| 65 6c 65 63 74 6f 72 3b | 20 6b 44 42 47 65 74 45 |elector;| kDBGetE|
|00005200| 72 72 0d 09 ab 09 30 32 | 09 64 64 65 76 53 74 6f |rr....02|.ddevSto|
|00005210| 72 61 67 65 09 6c 6f 6e | 67 20 09 73 74 6f 72 61 |rage.lon|g .stora|
|00005220| 67 65 20 66 6f 72 20 64 | 61 74 61 20 61 63 63 65 |ge for d|ata acce|
|00005230| 73 73 20 09 09 09 09 09 | 09 65 78 74 65 6e 73 69 |ss .....|.extensi|
|00005240| 6f 6e 0d 09 ae 09 30 36 | 09 61 73 79 6e 63 50 42 |on....06|.asyncPB|
|00005250| 09 6c 6f 6e 67 09 70 6f | 69 6e 74 65 72 20 74 6f |.long.po|inter to|
|00005260| 20 61 73 79 6e 63 68 20 | 70 61 72 61 6d 65 74 65 | asynch |paramete|
|00005270| 72 20 09 09 09 09 09 62 | 6c 6f 63 6b 0d 09 ae 09 |r .....b|lock....|
|00005280| 31 30 09 73 65 73 73 49 | 44 09 6c 6f 6e 67 09 73 |10.sessI|D.long.s|
|00005290| 65 73 73 69 6f 6e 20 49 | 44 0d 09 ac 09 35 30 09 |ession I|D....50.|
|000052a0| 65 72 72 31 09 6c 6f 6e | 67 09 70 72 69 6d 61 72 |err1.lon|g.primar|
|000052b0| 79 20 65 72 72 6f 72 20 | 63 6f 64 65 0d 09 ac 09 |y error |code....|
|000052c0| 35 34 09 65 72 72 32 09 | 6c 6f 6e 67 09 73 65 63 |54.err2.|long.sec|
|000052d0| 6f 6e 64 61 72 79 20 65 | 72 72 6f 72 20 63 6f 64 |ondary e|rror cod|
|000052e0| 65 0d 09 ac 09 35 38 09 | 69 74 65 6d 31 09 6c 6f |e....58.|item1.lo|
|000052f0| 6e 67 09 70 6f 69 6e 74 | 65 72 20 74 6f 20 66 69 |ng.point|er to fi|
|00005300| 72 73 74 20 6f 62 6a 65 | 63 74 20 6f 66 20 09 09 |rst obje|ct of ..|
|00005310| 09 09 09 09 65 72 72 6f | 72 20 0d 09 09 09 09 09 |....erro|r ......|
|00005320| 6d 65 73 73 61 67 65 0d | 09 ac 09 36 32 09 69 74 |message.|...62.it|
|00005330| 65 6d 32 09 6c 6f 6e 67 | 09 70 6f 69 6e 74 65 72 |em2.long|.pointer|
|00005340| 20 74 6f 20 73 65 63 6f | 6e 64 20 6f 62 6a 65 63 | to seco|nd objec|
|00005350| 74 20 6f 66 20 09 09 09 | 09 09 65 72 72 6f 72 20 |t of ...|..error |
|00005360| 0d 09 09 09 09 09 6d 65 | 73 73 61 67 65 0d 09 ac |......me|ssage...|
|00005370| 09 36 36 09 65 72 72 6f | 72 4d 73 67 09 6c 6f 6e |.66.erro|rMsg.lon|
|00005380| 67 09 70 6f 69 6e 74 65 | 72 20 74 6f 20 65 72 72 |g.pointe|r to err|
|00005390| 6f 72 20 6d 65 73 73 61 | 67 65 0d 54 68 65 20 44 |or messa|ge.The D|
|000053a0| 42 47 65 74 45 72 72 20 | 66 75 6e 63 74 69 6f 6e |BGetErr |function|
|000053b0| 20 72 65 74 72 69 65 76 | 65 73 20 65 72 72 6f 72 | retriev|es error|
|000053c0| 20 63 6f 64 65 73 20 61 | 6e 64 20 65 72 72 6f 72 | codes a|nd error|
|000053d0| 20 6d 65 73 73 61 67 65 | 73 20 66 72 6f 6d 20 61 | message|s from a|
|000053e0| 20 72 65 6d 6f 74 65 20 | 64 61 74 61 20 73 6f 75 | remote |data sou|
|000053f0| 72 63 65 2e 20 53 65 65 | 20 d2 53 65 6e 64 69 6e |rce. See| .Sendin|
|00005400| 67 20 61 6e 64 20 45 78 | 65 63 75 74 69 6e 67 20 |g and Ex|ecuting |
|00005410| 51 75 65 72 69 65 73 d3 | 20 69 6e 20 74 68 65 20 |Queries.| in the |
|00005420| 44 61 74 61 20 41 63 63 | 65 73 73 20 4d 61 6e 61 |Data Acc|ess Mana|
|00005430| 67 65 72 20 63 68 61 70 | 74 65 72 20 6f 66 20 49 |ger chap|ter of I|
|00005440| 6e 73 69 64 65 20 4d 61 | 63 69 6e 74 6f 73 68 20 |nside Ma|cintosh |
|00005450| 20 56 6f 6c 75 6d 65 20 | 56 49 20 66 6f 72 20 61 | Volume |VI for a|
|00005460| 20 63 6f 6d 70 6c 65 74 | 65 20 64 65 73 63 72 69 | complet|e descri|
|00005470| 70 74 69 6f 6e 20 6f 66 | 20 74 68 69 73 20 66 75 |ption of| this fu|
|00005480| 6e 63 74 69 6f 6e 2e 0d | 52 65 73 75 6c 74 20 63 |nction..|Result c|
|00005490| 6f 64 65 73 0d 6e 6f 45 | 72 72 20 20 20 20 20 20 |odes.noE|rr |
|000054a0| 20 20 30 09 4e 6f 20 65 | 72 72 6f 72 0d 72 63 44 | 0.No e|rror.rcD|
|000054b0| 42 45 72 72 6f 72 20 20 | 09 d0 38 30 32 09 45 72 |BError |..802.Er|
|000054c0| 72 6f 72 20 72 65 74 72 | 69 65 76 69 6e 67 20 65 |ror retr|ieving e|
|000054d0| 72 72 6f 72 20 69 6e 66 | 6f 72 6d 61 74 69 6f 6e |rror inf|ormation|
|000054e0| 0d 44 42 42 72 65 61 6b | 0d 50 61 72 61 6d 65 74 |.DBBreak|.Paramet|
|000054f0| 65 72 20 62 6c 6f 63 6b | 0d 09 ae 09 30 30 09 6d |er block|....00.m|
|00005500| 65 73 73 61 67 65 09 77 | 6f 72 64 09 72 6f 75 74 |essage.w|ord.rout|
|00005510| 69 6e 65 20 73 65 6c 65 | 63 74 6f 72 3b 20 6b 44 |ine sele|ctor; kD|
|00005520| 42 42 72 65 61 6b 0d 09 | ab 09 30 32 09 64 64 65 |BBreak..|..02.dde|
|00005530| 76 53 74 6f 72 61 67 65 | 09 6c 6f 6e 67 20 09 73 |vStorage|.long .s|
|00005540| 74 6f 72 61 67 65 20 66 | 6f 72 20 64 61 74 61 20 |torage f|or data |
|00005550| 61 63 63 65 73 73 20 09 | 09 09 09 09 09 65 78 74 |access .|.....ext|
|00005560| 65 6e 73 69 6f 6e 0d 09 | ae 09 30 36 09 61 73 79 |ension..|..06.asy|
|00005570| 6e 63 50 42 09 6c 6f 6e | 67 09 70 6f 69 6e 74 65 |ncPB.lon|g.pointe|
|00005580| 72 20 74 6f 20 61 73 79 | 6e 63 68 20 70 61 72 61 |r to asy|nch para|
|00005590| 6d 65 74 65 72 20 09 09 | 09 09 09 62 6c 6f 63 6b |meter ..|...block|
|000055a0| 0d 09 ae 09 31 30 09 73 | 65 73 73 49 44 09 6c 6f |....10.s|essID.lo|
|000055b0| 6e 67 09 73 65 73 73 69 | 6f 6e 20 49 44 0d 09 ae |ng.sessi|on ID...|
|000055c0| 09 38 38 09 61 62 6f 72 | 74 09 62 79 74 65 09 61 |.88.abor|t.byte.a|
|000055d0| 62 6f 72 74 20 66 6c 61 | 67 0d 54 68 65 20 44 42 |bort fla|g.The DB|
|000055e0| 42 72 65 61 6b 20 66 75 | 6e 63 74 69 6f 6e 20 63 |Break fu|nction c|
|000055f0| 61 6e 20 68 61 6c 74 20 | 65 78 65 63 75 74 69 6f |an halt |executio|
|00005600| 6e 20 6f 66 20 61 20 71 | 75 65 72 79 20 61 6e 64 |n of a q|uery and|
|00005610| 20 72 65 69 6e 69 74 69 | 61 6c 69 7a 65 20 74 68 | reiniti|alize th|
|00005620| 65 20 72 65 6d 6f 74 65 | 20 64 61 74 61 20 73 6f |e remote| data so|
|00005630| 75 72 63 65 2c 20 6f 72 | 20 69 74 20 63 61 6e 20 |urce, or| it can |
|00005640| 75 6e 63 6f 6e 64 69 74 | 69 6f 6e 61 6c 6c 79 20 |uncondit|ionally |
|00005650| 74 65 72 6d 69 6e 61 74 | 65 20 61 20 73 65 73 73 |terminat|e a sess|
|00005660| 69 6f 6e 20 77 69 74 68 | 20 61 20 64 61 74 61 20 |ion with| a data |
|00005670| 73 6f 75 72 63 65 2e 20 | 53 65 65 20 d2 53 65 6e |source. |See .Sen|
|00005680| 64 69 6e 67 20 61 6e 64 | 20 45 78 65 63 75 74 69 |ding and| Executi|
|00005690| 6e 67 20 51 75 65 72 69 | 65 73 d3 20 69 6e 20 74 |ng Queri|es. in t|
|000056a0| 68 65 20 44 61 74 61 20 | 41 63 63 65 73 73 20 4d |he Data |Access M|
|000056b0| 61 6e 61 67 65 72 20 63 | 68 61 70 74 65 72 20 6f |anager c|hapter o|
|000056c0| 66 20 49 6e 73 69 64 65 | 20 4d 61 63 69 6e 74 6f |f Inside| Macinto|
|000056d0| 73 68 20 56 6f 6c 75 6d | 65 20 56 49 20 66 6f 72 |sh Volum|e VI for|
|000056e0| 20 61 20 63 6f 6d 70 6c | 65 74 65 20 64 65 73 63 | a compl|ete desc|
|000056f0| 72 69 70 74 69 6f 6e 20 | 6f 66 20 74 68 69 73 20 |ription |of this |
|00005700| 66 75 6e 63 74 69 6f 6e | 2e 0d 52 65 73 75 6c 74 |function|..Result|
|00005710| 20 63 6f 64 65 73 0d 6e | 6f 45 72 72 20 20 20 20 | codes.n|oErr |
|00005720| 20 20 20 20 30 09 45 78 | 65 63 75 74 69 6f 6e 20 | 0.Ex|ecution |
|00005730| 68 61 73 20 62 65 67 75 | 6e 0d 72 63 44 42 45 72 |has begu|n.rcDBEr|
|00005740| 72 6f 72 09 d0 20 20 d0 | 38 30 32 09 42 72 65 61 |ror.. .|802.Brea|
|00005750| 6b 20 6f 72 20 61 62 6f | 72 74 20 61 74 74 65 6d |k or abo|rt attem|
|00005760| 70 74 20 77 61 73 20 75 | 6e 73 75 63 63 65 73 73 |pt was u|nsuccess|
|00005770| 66 75 6c 0d 44 42 47 65 | 74 49 74 65 6d 0d 50 61 |ful.DBGe|tItem.Pa|
|00005780| 72 61 6d 65 74 65 72 20 | 62 6c 6f 63 6b 0d 09 ae |rameter |block...|
|00005790| 09 30 30 09 6d 65 73 73 | 61 67 65 09 77 6f 72 64 |.00.mess|age.word|
|000057a0| 09 72 6f 75 74 69 6e 65 | 20 73 65 6c 65 63 74 6f |.routine| selecto|
|000057b0| 72 3b 20 6b 44 42 47 65 | 74 49 74 65 6d 0d 09 ab |r; kDBGe|tItem...|
|000057c0| 09 30 32 09 64 64 65 76 | 53 74 6f 72 61 67 65 09 |.02.ddev|Storage.|
|000057d0| 6c 6f 6e 67 20 09 73 74 | 6f 72 61 67 65 20 66 6f |long .st|orage fo|
|000057e0| 72 20 64 61 74 61 20 61 | 63 63 65 73 73 20 09 09 |r data a|ccess ..|
|000057f0| 09 09 09 09 65 78 74 65 | 6e 73 69 6f 6e 0d 09 ae |....exte|nsion...|
|00005800| 09 30 36 09 61 73 79 6e | 63 50 42 09 6c 6f 6e 67 |.06.asyn|cPB.long|
|00005810| 09 70 6f 69 6e 74 65 72 | 20 74 6f 20 61 73 79 6e |.pointer| to asyn|
|00005820| 63 68 20 70 61 72 61 6d | 65 74 65 72 20 09 09 09 |ch param|eter ...|
|00005830| 09 09 62 6c 6f 63 6b 0d | 09 ae 09 31 30 09 73 65 |..block.|...10.se|
|00005840| 73 73 49 44 09 6c 6f 6e | 67 09 73 65 73 73 69 6f |ssID.lon|g.sessio|
|00005850| 6e 20 49 44 0d 09 ae 09 | 34 36 09 62 75 66 66 65 |n ID....|46.buffe|
|00005860| 72 09 6c 6f 6e 67 09 70 | 6f 69 6e 74 65 72 20 74 |r.long.p|ointer t|
|00005870| 6f 20 64 61 74 61 20 62 | 75 66 66 65 72 0d 09 ae |o data b|uffer...|
|00005880| 09 37 30 09 74 69 6d 65 | 6f 75 74 09 6c 6f 6e 67 |.70.time|out.long|
|00005890| 09 74 69 6d 65 6f 75 74 | 20 76 61 6c 75 65 0d 09 |.timeout| value..|
|000058a0| ab 09 37 34 09 64 61 74 | 61 54 79 70 65 09 6c 6f |..74.dat|aType.lo|
|000058b0| 6e 67 09 64 61 74 61 20 | 74 79 70 65 0d 09 ab 09 |ng.data |type....|
|000058c0| 38 32 09 6c 65 6e 09 77 | 6f 72 64 09 6c 65 6e 67 |82.len.w|ord.leng|
|000058d0| 74 68 20 6f 66 20 64 61 | 74 61 20 69 74 65 6d 0d |th of da|ta item.|
|000058e0| 09 ab 09 38 34 09 70 6c | 61 63 65 73 09 77 6f 72 |...84.pl|aces.wor|
|000058f0| 64 09 64 65 63 69 6d 61 | 6c 20 70 6c 61 63 65 73 |d.decima|l places|
|00005900| 20 69 6e 20 64 61 74 61 | 20 69 74 65 6d 0d 09 ac | in data| item...|
|00005910| 09 38 36 09 66 6c 61 67 | 73 09 77 6f 72 64 09 66 |.86.flag|s.word.f|
|00005920| 6c 61 67 73 0d 54 68 65 | 20 44 42 47 65 74 49 74 |lags.The| DBGetIt|
|00005930| 65 6d 20 66 75 6e 63 74 | 69 6f 6e 20 72 65 74 72 |em funct|ion retr|
|00005940| 69 65 76 65 73 20 74 68 | 65 20 6e 65 78 74 20 64 |ieves th|e next d|
|00005950| 61 74 61 20 69 74 65 6d | 20 66 72 6f 6d 20 74 68 |ata item| from th|
|00005960| 65 20 64 61 74 61 20 73 | 6f 75 72 63 65 2e 20 53 |e data s|ource. S|
|00005970| 65 65 20 d2 52 65 74 72 | 69 65 76 69 6e 67 20 52 |ee .Retr|ieving R|
|00005980| 65 73 75 6c 74 73 d3 20 | 69 6e 20 74 68 65 20 44 |esults. |in the D|
|00005990| 61 74 61 20 41 63 63 65 | 73 73 20 4d 61 6e 61 67 |ata Acce|ss Manag|
|000059a0| 65 72 20 63 68 61 70 74 | 65 72 20 6f 66 20 49 6e |er chapt|er of In|
|000059b0| 73 69 64 65 20 4d 61 63 | 69 6e 74 6f 73 68 20 56 |side Mac|intosh V|
|000059c0| 6f 6c 75 6d 65 20 56 49 | 20 66 6f 72 20 61 20 63 |olume VI| for a c|
|000059d0| 6f 6d 70 6c 65 74 65 20 | 64 65 73 63 72 69 70 74 |omplete |descript|
|000059e0| 69 6f 6e 20 6f 66 20 74 | 68 69 73 20 66 75 6e 63 |ion of t|his func|
|000059f0| 74 69 6f 6e 2e 0d 52 65 | 73 75 6c 74 20 63 6f 64 |tion..Re|sult cod|
|00005a00| 65 73 0d 6e 6f 45 72 72 | 09 30 09 4e 6f 20 65 72 |es.noErr|.0.No er|
|00005a10| 72 6f 72 3b 20 6e 6f 20 | 6e 65 78 74 20 64 61 74 |ror; no |next dat|
|00005a20| 61 20 69 74 65 6d 0d 72 | 63 44 42 56 61 6c 75 65 |a item.r|cDBValue|
|00005a30| 09 d0 38 30 31 09 41 20 | 6e 6f 6e 7a 65 72 6f 20 |..801.A |nonzero |
|00005a40| 64 61 74 61 20 69 74 65 | 6d 20 77 61 73 20 73 75 |data ite|m was su|
|00005a50| 63 63 65 73 73 66 75 6c | 6c 79 0d 09 09 72 65 74 |ccessful|ly...ret|
|00005a60| 72 69 65 76 65 64 0d 72 | 63 44 42 4e 75 6c 6c 09 |rieved.r|cDBNull.|
|00005a70| d0 38 30 30 09 54 68 65 | 20 64 61 74 61 20 69 74 |.800.The| data it|
|00005a80| 65 6d 20 77 61 73 20 4e | 55 4c 4c 0d 72 63 44 42 |em was N|ULL.rcDB|
|00005a90| 45 72 72 6f 72 09 d0 38 | 30 32 09 4e 6f 20 6e 65 |Error..8|02.No ne|
|00005aa0| 78 74 20 64 61 74 61 20 | 69 74 65 6d 3b 20 65 78 |xt data |item; ex|
|00005ab0| 65 63 75 74 69 6f 6e 20 | 65 6e 64 65 64 20 69 6e |ecution |ended in|
|00005ac0| 20 61 6e 20 65 72 72 6f | 72 0d 72 63 44 42 42 61 | an erro|r.rcDBBa|
|00005ad0| 64 54 79 70 65 09 d0 38 | 30 33 09 4e 65 78 74 20 |dType..8|03.Next |
|00005ae0| 64 61 74 61 20 69 74 65 | 6d 20 6e 6f 74 20 6f 66 |data ite|m not of|
|00005af0| 20 72 65 71 75 65 73 74 | 65 64 20 64 61 74 61 20 | request|ed data |
|00005b00| 74 79 70 65 0d 72 63 44 | 42 42 72 65 61 6b 09 d0 |type.rcD|BBreak..|
|00005b10| 38 30 35 09 54 69 6d 65 | 64 20 6f 75 74 0d 44 42 |805.Time|d out.DB|
|00005b20| 55 6e 47 65 74 49 74 65 | 6d 0d 50 61 72 61 6d 65 |UnGetIte|m.Parame|
|00005b30| 74 65 72 20 62 6c 6f 63 | 6b 0d 09 ae 09 30 30 09 |ter bloc|k....00.|
|00005b40| 6d 65 73 73 61 67 65 09 | 77 6f 72 64 09 72 6f 75 |message.|word.rou|
|00005b50| 74 69 6e 65 20 73 65 6c | 65 63 74 6f 72 3b 20 09 |tine sel|ector; .|
|00005b60| 09 09 09 09 09 09 6b 44 | 42 55 6e 47 65 74 49 74 |......kD|BUnGetIt|
|00005b70| 65 6d 0d 09 ab 09 30 32 | 09 64 64 65 76 53 74 6f |em....02|.ddevSto|
|00005b80| 72 61 67 65 09 6c 6f 6e | 67 20 09 73 74 6f 72 61 |rage.lon|g .stora|
|00005b90| 67 65 20 66 6f 72 20 64 | 61 74 61 20 61 63 63 65 |ge for d|ata acce|
|00005ba0| 73 73 20 09 09 09 09 09 | 09 65 78 74 65 6e 73 69 |ss .....|.extensi|
|00005bb0| 6f 6e 0d 09 ae 09 30 36 | 09 61 73 79 6e 63 50 42 |on....06|.asyncPB|
|00005bc0| 09 6c 6f 6e 67 09 70 6f | 69 6e 74 65 72 20 74 6f |.long.po|inter to|
|00005bd0| 20 61 73 79 6e 63 68 20 | 70 61 72 61 6d 65 74 65 | asynch |paramete|
|00005be0| 72 20 09 09 09 09 09 62 | 6c 6f 63 6b 0d 09 ae 09 |r .....b|lock....|
|00005bf0| 31 30 09 73 65 73 73 49 | 44 09 6c 6f 6e 67 09 73 |10.sessI|D.long.s|
|00005c00| 65 73 73 69 6f 6e 20 49 | 44 0d 54 68 65 20 44 42 |ession I|D.The DB|
|00005c10| 55 6e 47 65 74 49 74 65 | 6d 20 66 75 6e 63 74 69 |UnGetIte|m functi|
|00005c20| 6f 6e 20 72 65 76 65 72 | 73 65 73 20 74 68 65 20 |on rever|ses the |
|00005c30| 65 66 66 65 63 74 20 6f | 66 20 74 68 65 20 6c 61 |effect o|f the la|
|00005c40| 73 74 20 63 61 6c 6c 20 | 74 6f 20 74 68 65 20 44 |st call |to the D|
|00005c50| 42 47 65 74 49 74 65 6d | 20 66 75 6e 63 74 69 6f |BGetItem| functio|
|00005c60| 6e 2e 20 53 65 65 20 d2 | 52 65 74 72 69 65 76 69 |n. See .|Retrievi|
|00005c70| 6e 67 20 52 65 73 75 6c | 74 73 d3 20 69 6e 20 74 |ng Resul|ts. in t|
|00005c80| 68 65 20 44 61 74 61 20 | 41 63 63 65 73 73 20 4d |he Data |Access M|
|00005c90| 61 6e 61 67 65 72 20 63 | 68 61 70 74 65 72 20 6f |anager c|hapter o|
|00005ca0| 66 20 49 6e 73 69 64 65 | 20 4d 61 63 69 6e 74 6f |f Inside| Macinto|
|00005cb0| 73 68 20 56 6f 6c 75 6d | 65 20 56 49 20 66 6f 72 |sh Volum|e VI for|
|00005cc0| 20 61 20 63 6f 6d 70 6c | 65 74 65 20 64 65 73 63 | a compl|ete desc|
|00005cd0| 72 69 70 74 69 6f 6e 20 | 6f 66 20 74 68 69 73 20 |ription |of this |
|00005ce0| 66 75 6e 63 74 69 6f 6e | 2e 0d 52 65 73 75 6c 74 |function|..Result|
|00005cf0| 20 63 6f 64 65 73 0d 6e | 6f 45 72 72 20 20 20 20 | codes.n|oErr |
|00005d00| 20 20 20 20 20 30 09 4e | 6f 20 65 72 72 6f 72 0d | 0.N|o error.|
|00005d10| 72 63 44 42 45 72 72 6f | 72 20 20 20 20 d0 38 30 |rcDBErro|r .80|
|00005d20| 32 09 45 72 72 6f 72 20 | 65 78 65 63 75 74 69 6e |2.Error |executin|
|00005d30| 67 20 66 75 6e 63 74 69 | 6f 6e 0d 46 75 72 74 68 |g functi|on.Furth|
|00005d40| 65 72 20 52 65 66 65 72 | 65 6e 63 65 3a 0d a5 09 |er Refer|ence:...|
|00005d50| 49 6e 73 69 64 65 20 4d | 61 63 69 6e 74 6f 73 68 |Inside M|acintosh|
|00005d60| 2c 20 56 6f 6c 75 6d 65 | 20 56 49 2c 20 44 61 74 |, Volume| VI, Dat|
|00005d70| 61 20 41 63 63 65 73 73 | 20 4d 61 6e 61 67 65 72 |a Access| Manager|
|00005d80| 20 63 68 61 70 74 65 72 | 0d 19 5a 00 00 00 00 03 | chapter|..Z.....|
|00005d90| 48 02 52 00 11 02 ff 0c | 00 ff ff ff ff 00 00 00 |H.R.....|........|
|00005da0| 00 00 00 00 00 02 52 00 | 00 03 48 00 00 00 00 00 |......R.|..H.....|
|00005db0| 00 00 a1 00 64 00 0c 57 | 4f 52 44 00 00 00 00 00 |....d..W|ORD.....|
|00005dc0| 53 01 ca 00 a0 00 8c 00 | a1 00 64 00 0c 57 4f 52 |S.......|..d..WOR|
|00005dd0| 44 00 00 00 00 00 52 01 | c9 00 a0 00 82 00 1e 00 |D.....R.|........|
|00005de0| 01 00 0a 00 2f 00 5a 00 | 81 02 23 00 07 00 00 00 |..../.Z.|..#.....|
|00005df0| 00 00 08 00 0a 00 09 30 | 49 88 3a b5 9c f0 39 00 |.......0|I.:...9.|
|00005e00| 22 00 7b 02 1a 00 00 00 | 09 ff ff ff ff ff ff ff |".{.....|........|
|00005e10| ff 00 23 00 00 00 a0 00 | c4 00 a1 00 64 00 0a 4f |..#.....|....d..O|
|00005e20| 4e 4c 4e 00 66 00 00 01 | fe 00 a0 00 8c 00 a1 00 |NLN.f...|........|
|00005e30| 64 00 31 64 72 77 32 00 | 02 01 c9 00 2d 01 e1 01 |d.1drw2.|....-...|
|00005e40| 5f 00 00 80 00 00 00 00 | 00 00 00 00 00 00 00 00 |_.......|........|
|00005e50| 00 00 00 00 00 ff ff ff | ff ff ff 00 01 00 00 01 |........|........|
|00005e60| 8f 00 00 00 00 00 a1 00 | 96 00 0c 01 00 00 00 02 |........|........|
|00005e70| 78 00 00 00 00 00 00 00 | a1 00 64 00 10 64 72 77 |x.......|..d..drw|
|00005e80| 32 00 3a 00 05 00 00 00 | 00 00 01 00 00 00 a1 00 |2.:.....|........|
|00005e90| 64 00 0e 64 72 77 32 00 | 3a 00 02 00 24 00 00 00 |d..drw2.|:...$...|
|00005ea0| 00 00 a1 00 64 00 34 64 | 72 77 32 00 3a 00 01 00 |....d.4d|rw2.:...|
|00005eb0| 03 01 00 00 18 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00005ec0| 01 00 01 00 01 00 01 00 | 00 00 00 00 00 00 00 00 |........|........|
|00005ed0| 00 00 00 00 00 00 00 00 | 00 00 00 00 a1 00 9a 00 |........|........|
|00005ee0| 08 ff fa 00 00 00 97 40 | 00 00 a0 00 98 00 2c 00 |.......@|......,.|
|00005ef0| 08 00 14 05 54 69 6d 65 | 73 00 03 00 14 00 04 01 |....Time|s.......|
|00005f00| 00 00 0d 00 18 00 2e 00 | 04 00 00 01 00 00 10 5e |........|.......^|
|00005f10| 0b 74 4b 5e 0b 74 4b 00 | 2b 5d 42 13 4e 65 77 20 |.tK^.tK.|+]B.New |
|00005f20| 54 65 63 68 6e 69 63 61 | 6c 20 4e 6f 74 65 73 00 |Technica|l Notes.|
|00005f30| a0 00 99 00 a1 00 64 00 | 08 64 72 77 32 00 3a 00 |......d.|.drw2.:.|
|00005f40| 04 00 a1 14 e3 00 02 00 | 01 00 a0 00 97 00 a1 00 |........|........|
|00005f50| 64 00 31 64 72 77 32 00 | 02 02 06 01 65 02 19 01 |d.1drw2.|....e...|
|00005f60| f4 00 00 80 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00005f70| 00 00 00 00 00 ff ff ff | ff ff ff 00 01 00 00 01 |........|........|
|00005f80| 50 00 00 00 00 00 a1 00 | 96 00 0c 01 00 00 00 02 |P.......|........|
|00005f90| 78 00 00 00 00 00 00 00 | a1 00 64 00 10 64 72 77 |x.......|..d..drw|
|00005fa0| 32 00 3a 00 05 00 00 00 | 00 00 01 00 00 00 a1 00 |2.:.....|........|
|00005fb0| 64 00 0e 64 72 77 32 00 | 3a 00 02 00 24 00 00 00 |d..drw2.|:...$...|
|00005fc0| 00 00 a1 00 64 00 34 64 | 72 77 32 00 3a 00 01 00 |....d.4d|rw2.:...|
|00005fd0| 03 00 00 00 12 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00005fe0| 01 00 01 00 01 00 01 00 | 00 00 00 00 00 00 00 00 |........|........|
|00005ff0| 00 00 00 00 00 00 00 00 | 00 00 00 00 a1 00 9a 00 |........|........|
|00006000| 08 ff fb 80 00 00 45 c0 | 00 00 a0 00 98 00 04 00 |......E.|........|
|00006010| 00 00 0d 00 12 00 15 16 | 80 00 28 00 7b 01 95 11 |........|..(.{...|
|00006020| 44 65 76 65 6c 6f 70 65 | 72 20 53 75 70 70 6f 72 |Develope|r Suppor|
|00006030| 74 00 a0 00 99 00 a1 00 | 64 00 08 64 72 77 32 00 |t.......|d..drw2.|
|00006040| 3a 00 04 00 a1 14 e3 00 | 02 00 01 00 a0 00 97 00 |:.......|........|
|00006050| a1 00 64 00 60 64 72 77 | 32 00 03 02 00 00 2d 02 |..d.`drw|2.....-.|
|00006060| 00 01 ef 00 00 00 00 00 | 00 00 00 02 02 00 00 00 |........|........|
|00006070| 00 00 00 00 00 00 00 ff | ff ff ff ff ff 00 01 00 |........|........|
|00006080| 01 08 4b 00 00 00 00 02 | 00 01 ef 02 00 00 2d 00 |..K.....|......-.|
|00006090| 00 00 00 00 00 00 00 00 | 01 00 14 00 0c 00 03 00 |........|........|
|000060a0| 02 00 00 00 5a 00 01 00 | 00 00 02 00 00 00 03 00 |....Z...|........|
|000060b0| 0c 00 00 00 00 00 07 00 | 02 00 02 00 08 00 08 00 |........|........|
|000060c0| 20 00 66 02 1c 00 66 00 | 5a 00 a1 00 64 00 31 64 | .f...f.|Z...d.1d|
|000060d0| 72 77 32 00 02 01 ca 01 | c0 01 fa 01 e9 00 00 00 |rw2.....|........|
|000060e0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000060f0| 00 ff ff ff ff ff ff 00 | 01 00 00 01 4b 00 00 00 |........|....K...|
|00006100| 00 00 a1 00 96 00 0c 01 | 00 00 00 02 78 00 00 00 |........|....x...|
|00006110| 00 00 00 00 a1 00 64 00 | 10 64 72 77 32 00 3a 00 |......d.|.drw2.:.|
|00006120| 05 00 00 00 00 00 01 00 | 00 00 a1 00 64 00 0e 64 |........|....d..d|
|00006130| 72 77 32 00 3a 00 02 00 | 24 00 00 00 00 00 a1 00 |rw2.:...|$.......|
|00006140| 64 00 34 64 72 77 32 00 | 3a 00 01 00 03 00 00 00 |d.4drw2.|:.......|
|00006150| 30 00 00 00 00 00 00 00 | 00 00 00 00 01 00 01 00 |0.......|........|
|00006160| 01 00 01 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00006170| 00 00 00 00 00 00 00 00 | a1 00 9a 00 08 ff f4 00 |........|........|
|00006180| 00 00 13 80 00 00 a0 00 | 98 00 0d 00 30 00 28 00 |........|....0.(.|
|00006190| 55 01 ef 01 f0 00 a0 00 | 99 00 a1 00 64 00 08 64 |U.......|....d..d|
|000061a0| 72 77 32 00 3a 00 04 00 | a1 14 e3 00 02 00 01 00 |rw2.:...|........|
|000061b0| a0 00 97 00 a1 00 64 00 | 31 64 72 77 32 00 02 01 |......d.|1drw2...|
|000061c0| ef 01 e6 01 fa 01 f0 00 | 00 00 00 00 00 00 00 00 |........|........|
|000061d0| 00 00 00 00 00 00 00 00 | 00 00 00 ff ff ff ff ff |........|........|
|000061e0| ff 00 01 00 00 01 00 00 | 00 00 00 00 a1 00 96 00 |........|........|
|000061f0| 0c 01 00 00 00 02 78 00 | 00 00 00 00 00 00 a1 00 |......x.|........|
|00006200| 64 00 10 64 72 77 32 00 | 3a 00 05 00 00 00 00 00 |d..drw2.|:.......|
|00006210| 01 00 00 00 a1 00 64 00 | 0e 64 72 77 32 00 3a 00 |......d.|.drw2.:.|
|00006220| 02 00 24 00 00 00 00 00 | a1 00 64 00 34 64 72 77 |..$.....|..d.4drw|
|00006230| 32 00 3a 00 01 00 03 00 | 00 00 09 00 00 00 00 00 |2.:.....|........|
|00006240| 00 00 00 00 00 00 01 00 | 01 00 01 00 01 00 00 00 |........|........|
|00006250| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00006260| 00 00 a1 00 9a 00 08 ff | fd 80 00 00 04 00 00 00 |........|........|
|00006270| a0 00 98 00 0d 00 09 00 | 15 6c 00 00 2b 26 09 01 |........|.l..+&..|
|00006280| a8 00 a0 00 99 00 a1 00 | 64 00 08 64 72 77 32 00 |........|d..drw2.|
|00006290| 3a 00 04 00 a1 14 e3 00 | 02 00 01 00 a0 00 97 00 |:.......|........|
|000062a0| a1 00 64 00 31 64 72 77 | 32 00 02 01 e5 00 2d 01 |..d.1drw|2.....-.|
|000062b0| f8 00 79 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |..y.....|........|
|000062c0| 00 00 00 00 00 00 00 ff | ff ff ff ff ff 00 01 00 |........|........|
|000062d0| 01 01 00 00 00 01 00 00 | a1 00 96 00 0c 01 00 00 |........|........|
|000062e0| 00 02 78 00 00 00 00 00 | 00 00 a1 00 64 00 10 64 |..x.....|....d..d|
|000062f0| 72 77 32 00 3a 00 05 00 | 00 00 00 00 01 00 00 00 |rw2.:...|........|
|00006300| a1 00 64 00 0e 64 72 77 | 32 00 3a 00 02 00 24 00 |..d..drw|2.:...$.|
|00006310| 00 00 00 00 a1 00 64 00 | 34 64 72 77 32 00 3a 00 |......d.|4drw2.:.|
|00006320| 01 00 03 00 00 00 12 00 | 00 00 00 00 00 00 00 00 |........|........|
|00006330| 00 00 01 00 01 00 01 00 | 01 00 00 00 00 00 00 00 |........|........|
|00006340| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 a1 00 |........|........|
|00006350| 9a 00 08 ff fb 80 00 00 | 25 00 00 00 a0 00 98 00 |........|%.......|
|00006360| 0d 00 12 00 15 42 80 00 | 28 00 5a 00 5c 09 4d 61 |.....B..|(.Z.\.Ma|
|00006370| 63 69 6e 74 6f 73 68 00 | a0 00 99 00 a1 00 64 00 |cintosh.|......d.|
|00006380| 08 64 72 77 32 00 3a 00 | 04 00 a1 14 e3 00 02 00 |.drw2.:.|........|
|00006390| 01 00 a0 00 97 00 a0 00 | 8d 00 a1 00 64 00 06 64 |........|....d..d|
|000063a0| 72 77 32 00 44 00 a0 00 | 83 00 a1 00 64 00 04 57 |rw2.D...|....d..W|
|000063b0| 4f 52 44 00 a0 00 8d 00 | 01 00 0a 00 00 00 00 03 |ORD.....|........|
|000063c0| 48 02 52 00 04 01 00 00 | 2e 00 04 00 00 00 00 00 |H.R.....|........|
|000063d0| 10 00 01 00 01 00 01 00 | 01 00 a1 00 64 00 10 4f |........|....d..O|
|000063e0| 4e 4c 4e 00 64 00 00 00 | 8e 00 5a 00 a1 01 6b 00 |NLN.d...|..Z...k.|
|000063f0| 28 00 9c 00 5a 1e 4e 57 | 20 31 37 20 2d 20 44 61 |(...Z.NW| 17 - Da|
+--------+-------------------------+-------------------------+--------+--------+
Only 25.0 KB of data is shown above.